Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
11g Release 1 (



metricLabel metric label

Use the metricLabel tag to position the label for the gauge metric.

Relationship with other tags

The metricLabel tag is a child tag of the gauge tag.
The metricLabel tag has the following child tags: dvt:gaugeFont, dvt:numberFormat(deprecated) and af:convertNumber.

Note: The use of <dvt:numberFormat> is now replaced with <af:convertNumber> tag.


The following example shows the XML for a metricLabel tag.

      <dvt:metricLabel position="LP_BELOW_GAUGE" numberType="NT_PERCENT">
         <dvt:gaugeFont name="Tahoma" size="11" color="#3C3C3C" bold="true" italic="false"/> 


Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for the component
scaling java.lang.String no Specifies the scale factor of this label Valid values are:
  • auto - Automatically scales the number.
  • none - Scales the number to units
  • thousand - Scales the number to thousands.
  • million - Scales the number to millions.
  • billion - Scale the number to billions.
  • trillion - Scale the number to trillions.
  • quadrillion - Scale the number to quadrillions.
autoPrecision java.lang.String no Specifies the auto precision function of this label Valid values are:
  • on - The engine decides the number of digits on the numbers.
  • off - User specifies the number of digits on the numbers.
position java.lang.String no Specifies the location of the metric label, if any. Valid values:
  • LP_NONE - Displays no metric label.
  • LP_BELOW_GAUGE - Displays the metric label below the gauge. Note: If the position of both the bottom label and the metric label is set to LP_BELOW_GAUGE, then both labels are displayed below the gauge. However, the bottom label is displayed above the metric label.
  • LP_WITH_BOTTOM_LABEL - (Default) Displays the metric label beside the bottom label. Note: If the position of the bottom label is set to LP_NONE, the metric label will not be displayed.
  • LP_INSIDE_GAUGE - Displays the metric label inside the gauge. Note: Top, bottom, and metric labels are horizontally centered across a gauge. When these labels are positioned inside a gauge, they are also centered vertically within the gauge plot area.
numberType java.lang.String no Format for numbers that are displayed in the metric label. Valid values are:
  • NT_NUMBER - (Default) Specifies that the actual value is displayed.
  • NT_PERCENT - Specifies that percentages are displayed and the axis is scaled from 0 to 100%.