When to use it
Use for a current bounded metric, not task completion. Use Progress when the value represents work moving toward completion.
Data displayAndroid
Gauge
Show a normalized circular native metric with a formatted accessible value.
Native example
Use Gauge
Use for a current bounded metric, not task completion. Use Progress when the value represents work moving toward completion.
LumenGauge(
label = "Thermal pressure",
value = 48f,
valueLabel = "Fair",
tone = LumenMetricTone.Warning
)Reference
Public API
The primary shared and platform-specific options exposed by LumenGauge.
| API | Values or type | Default | Description |
|---|---|---|---|
| label | String | Required | Names the bounded metric. |
| value | Float | Required | Provides the current value. |
| max | Float | 100 | Provides the positive maximum. |
| valueLabel | String | Required | Provides the visible and accessible formatted value. |
| tone | neutral · brand · accent · success · warning · danger | brand | Selects semantic emphasis. |
Native behavior
Design and accessibility
Accessibility
The visual ring is replaced by one accessible label and formatted value. Invalid values are normalized into the valid range.
Shared component