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-valuemin
is missing or not a number, it defaults to 0 (zero). - If
aria-valuemax
is 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.