Meter

Meter

Display a value within a known range using the native HTML meter element.

Based on APG Meter Pattern.

Demo

75%75%
30%30%
90%90%

Usage

@styled_meter.meter(
  "storage",
  75.0,
  label="Storage used",
  value_text="75%",
)

@styled_meter.meter(
  "battery",
  30.0,
  low=20.0,
  high=80.0,
  optimum=100.0,
  label="Battery level",
  value_text="30%",
)

Props

PropTypeDefaultDescription
idString-Meter ID
valueDouble-Current value
minDouble0Minimum value
maxDouble100Maximum value
lowDouble?NoneLow threshold
highDouble?NoneHigh threshold
optimumDouble?NoneOptimal value
labelString?NoneLabel text
value_textString?NoneValue display text
classString?NoneAdditional CSS class

BEM Classes

ClassDescription
.meterRoot container
.meter__labelLabel element
.meter__elementNative meter element
.meter__valueValue text display

Accessibility

  • Uses native <meter> element for semantics

  • Label associated via for attribute

  • Browser handles color coding based on thresholds