WAI-ARIA: Role-Meter
An element that represents a scalar measurement within a known range, or a fractional value.
Description
An element that represents a scalar measurement within a known range, or a fractional value.
Authors MAY set aria-valuemin and aria-valuemax to indicate the minimum and maximum values for the meter. Otherwise, their implicit values follow the same rules as <input[type="range"]> in [HTML]:
- If
aria-valueminis missing or not a number, it defaults to 0 (zero). - If
aria-valuemaxis missing or not a number, it defaults to 100.
The value of aria-valuenow MUST NOT fall below or exceed the computed values of aria-valuemin and aria-valuemax, respectively.
Authors SHOULD NOT use the meter role to indicate progress; the progressbar role exists to address that need.
NOTE: Presently, there are no WAI-ARIA properties corresponding to the low, optimum, and high attributes supported on the <meter> element in [HTML]. The addition of these properties will be considered for ARIA version 1.3.
Characteristics
Superclass Role
Related Concepts
<meter> in [HTML]
Required States and Properties
Inherited States and Properties
- aria-atomic
- aria-busy (state)
- aria-controls
- aria-current (state)
- aria-describedby
- aria-details
- aria-disabled (state)
- aria-dropeffect
- aria-errormessage
- aria-flowto
- aria-grabbed (state)
- aria-haspopup
- aria-hidden (state)
- aria-invalid (state)
- aria-keyshortcuts
- aria-label
- aria-labelledby
- aria-live
- aria-owns
- aria-relevant
- aria-roledescription
- aria-valuemax
- aria-valuemin
- aria-valuetext
Accessible Name Required
True
Children Presentational
True
Implicit Value for Role
Default for aria-valuemin is 0.
Default for aria-valuemax is 100
Semantic HTML
The HTML alternative for role=”meter” is the <meter> tag.
Reference
- WAI-ARIA 1.2 Specification
Refer to the notes from the WAI-ARIA 1.2 specification for more information on role=meter.






