Gauge
One reading against a fixed range, as a filled arc or as a needle over coloured bands.
When to use it
Only when the range itself means something (0–100%, a rated temperature). Otherwise the number belongs in a stat tile. Bands are status, so they use status tones.
Filled and banded
Options
Everything you can pass to Gauge.
| Prop | Type | Default | What it does |
|---|---|---|---|
| value | number | null | — | null shows the "No reading" state. |
| min / max | number | 0 / 100 | The scale. |
| bands | { to, tone, label? }[] | — | Each runs up to its to. With bands the gauge draws a needle. |
| label | string | — | Under the figure, and in the screen-reader text. |
| height / valueFormatter / aria-label | — | — | As the other charts. |