Skip to content

Gauge

Display a numeric value against a range.

CONTROLREQUIRES A TAG

Three gauges showing the same value: a circular arc, a horizontal bar and a vertical bar.

The three appearances, each showing the same value: arc, horizontal bar, vertical bar.

A gauge displays one numeric tag against a fixed range, changing color at any thresholds you set.

It reads the tag and never writes to it.

  1. Open the document and select the screen you want from the screen tabs.
  2. In the control palette, press Gauge and drag it onto the canvas.
  3. Bind it to a tag, then set the range that tag actually moves through.
Property Description Default
Tag The value to display. none
Title Label above the value. Gauge
Unit Suffix shown after the number. none
Min / Max The ends of the range. 0 / 100
Decimals Digits after the decimal point. 0
Appearance Arc, horizontal bar, or vertical bar. arc
Color Fill color below the first threshold. primary
Thresholds Values at which the fill changes color. 75 warning, 90 error
Background / Track / Value / Title colors Individual overrides. theme tokens

A threshold is a value and a color: at or above that value, the fill takes that color. They arrive set to amber at 75 and red at 90.

  • Tags — naming the value a gauge reads.
  • Slider — when the operator needs to set the number rather than watch it.
  • Indicator — for a state rather than a quantity.