Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (



metricLabel metric label

This tag is deprecated since the parent tag, "gauge", is deprecated. Use dialGauge, ledGauge, or statusMeterGauge instead.

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 yes 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 yes 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 yes 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 yes 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%.