| Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces 12c (12.2.1.3) E80087-01 |
dvt:dialGauge dialGauge dial gauge
UIComponent class: oracle.adf.view.faces.bi.component.gauge.UIDialGauge
Component type: oracle.dss.adf.gauge.DialGauge
A gauge displaying a metric value plotted on a circular axis.
<dvt:dialGauge value="23" minimum="0" maximum="100"/>
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), autodisplay: none (default), autoGauge labels can be configured using dvt:gaugeMetricLabel and dvt:gaugeTickLabel.
Number formatting options are available through dvt:gaugeMetricLabel and dvt:gaugeTickLabel.
Popups and context menus can be displayed using af:showPopupBehavior.
The readOnly attribute can be set to false enabling the end user to change the metric value of the gauge. The value change can be processed using valueChangeListener on the server or the valueChange and input event types on the client.
| 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. |
| background | String | Yes | Valid Values: auto, circleAlta, circleAntique, circleDark, circleLight, domeAlta, domeAntique, domeDark, domeLight, rectangleAlta, rectangleAntique, rectangleDark, rectangleLight Default Value: auto Specifies the background style for the dial gauge. When set to auto, the primary design for the current skin will be used. |
| binding | oracle.adf.view.faces.bi.component.gauge.UIDialGauge | Only EL |
Specifies a binding reference to store a specific instance of UIDialGauge 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: |
| emptyText | String | Yes | The text of the component when empty. |
| id | String | No | Specifies the identifier for the component |
| indicator | String | Yes | Valid Values: auto, needleAlta, needleAntique, needleDark, needleLight Default Value: auto Specifies the indicator style for the dial gauge. When set to auto, the indicator will match the background. |
| 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. |
| readOnly | boolean | Yes | Default Value: true Specifies whether the value of the gauge can be changed by the end user. |
| rendered | boolean | Yes | Default Value: true Specifies whether the component is rendered. |
| shortDesc | String | Yes | The short description of this component. This is used to customize the tooltip text. |
| styleClass | String | Yes | Sets a CSS style class to use for this component. |
| value | Number | Yes | The metric value for the gauge. |
| valueChangeListener | javax.el.MethodExpression | Only EL | A method reference to a value change listener |
| visualEffects | String | Yes | Valid Values: none, auto Default Value: auto Specifies whether visual effects such as gradients and overlays are enabled. |