Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces 12c (12.2.1.2) E76719-01 |
dvt:ledGauge ledGauge led gauge
UIComponent class: oracle.adf.view.faces.bi.component.gauge.UILedGauge
Component type: oracle.dss.adf.gauge.LedGauge
A gauge displaying a metric value using a shape and color.
<dvt:ledGauge value="23" minimum="0" maximum="100" type="circle"> <dvt:gaugeThreshold maximum="33"/> <dvt:gaugeThreshold maximum="67"/> <dvt:gaugeThreshold/> </dvt:ledGauge>
Animations can be enabled on data change or on initial display by adding af:transition
as a child of this component. The following trigger types and transitions are supported:
dataChange
: none
(default), auto
display
: none
(default), auto
The gauge metric label can be configured using dvt:gaugeMetricLabel
. By default, the label color and size will be optimized to fit within the led shape.
Number formatting options are available through dvt:gaugeMetricLabel
.
The size of the led shape within the allocated component space can be customized using the size
attribute. This can be used to display an additional data dimension.
Thresholds can be added to the gauge using dvt:gaugeThreshold
. The value of the last threshold is automatically specified to be the maximum value of the gauge.
Visual effects such as gradients and overlays can be disabled to achieve a flatter look using the visualEffects
attribute.
Popups and context menus can be displayed using af:showPopupBehavior
.
Type | Phases | Description |
---|---|---|
org.apache.myfaces.trinidad.event.AttributeChangeEvent | Invoke Application, Apply Request Values |
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing. |
Name | Type | Supports EL? | Description |
---|---|---|---|
action | javax.el.MethodExpression | Yes | A reference to an action method sent by the component, or the static outcome of an action. |
actionListener | javax.faces.el.MethodBinding | Only EL | A method reference to an action listener |
attributeChangeListener | javax.el.MethodExpression | Only EL | a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing. |
binding | oracle.adf.view.faces.bi.component.gauge.UILedGauge | Only EL |
Specifies a binding reference to store a specific instance of UILedGauge from a backing bean. Set this attribute only to access code in a backing bean. For example, to reference a gauge component in the sample managed bean, use the following code: |
borderColor | String | Yes | Specifies the border color of the gauge indicator. Valid values are RGB hexadecimal. |
color | String | Yes | Specifies the fill color of the gauge indicator. Valid values are RGB hexadecimal. |
emptyText | String | Yes | The text of the component when empty. |
id | String | No | Specifies the identifier for the component |
inlineStyle | String | Yes | Style of the outer element (enclosing div) of the component |
maximum | Number | Yes | The maximum value for the gauge. |
minimum | Number | Yes | The minimum value for the gauge. |
partialTriggers | String[] | Yes | The IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too. |
rendered | boolean | Yes | Default Value: true Specifies whether the component is rendered. |
rotation | Number | Yes | Valid Values: 0, 90, 180, 270 Default Value: 0 Specifies the rotation angle for the gauge, which is useful for changing the direction of arrow and triangle gauges. |
shortDesc | String | Yes | The short description of this component. This is used to customize the tooltip text. |
size | Number | Yes | Default Value: 1.0 The relative size of the LED gauge shape. Valid values range from 0 to 1 (default). |
styleClass | String | Yes | Sets a CSS style class to use for this component. |
type | String | Yes | Valid Values: arrow, circle, diamond, rectangle, star, triangle Default Value: circle Specifies the shape of the LED gauge. |
value | Number | Yes | The metric value for the gauge. |
visualEffects | String | Yes | Valid Values: none, auto Default Value: auto Specifies whether visual effects such as gradients and overlays are enabled. |