tickLabel tick label

Use the tickLabel tag to specify which tick marks in a gauge have labels. This tag also determines the type of number that appears in the label.

Relationship with other tags

The tickLabel tag is a child tag of the gauge tag.
The tickLabel 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 tickLabel tag.

      <dvt:tickLabel content="TC_THRESHOLD TC_METRIC" 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
content java.lang.String yes Specifies where tick labels occur within a gauge set. Valid values include any combination of the following separated by spaces or commas:

Default value is: TC_MIN_MAX | TC_INCREMENTS

  • TC_INCREMENTS - Displays tick labels by increments.
  • TC_MAJOR_TICK - Displays tick labels for minimum, maximum, and increments.
  • TC_MIN_MAX - Displays tick labels for minimum and maximum values.
  • TC_METRIC - Displays tick labels for actual metric values.
  • TC_NONE - Displays no tick labels.
  • TC_THRESHOLD - Displays tick labels for threshold values.
numberType java.lang.String yes Format for numbers that are displayed in the tick labels. 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%.
position java.lang.String yes Specifies the position of the tick labels. Valid values are:
  • TLP_EXTERIOR - Specifies that the tick labels are displayed outside the plotArea.
  • TLP_INTERIOR - (Default) Specifies that the tick labels are displayed inside the plotArea.
scaling java.lang.String yes Scaling factor for numbers that are displayed. Valid values are:
  • auto - (Default) The number will be scaled automatically.
  • none - The number will not be scaled.
  • thousand - The number will be scaled to thousands.
  • million - The number will be scaled to millions.
  • billion - The number will be scaled to billions.
  • trillion - The number will be scaled to trillions.
  • quadrillion - The number will be scaled to quadrillions.
autoPrecision java.lang.String yes Whether to turn on the automatic precision for decimal digits. Valid values are:
  • on - (Default) The number of decimal digits are determined automatically.
  • off - The number of digits is based on the user specification from af:convertNumber