aria-valuetext
Characteristics
Type:
- DOMString
Related Concepts:
- XForms
- range
- start
Used in Roles:
- range
Inherits into Roles:
- progressbar
- scrollbar
- slider
- spinbutton
Value:
- string
Defines the human readable text alternative of aria-valuenow for a range widget.
You should only set the aria-valuetext attribute when the value of a slider or progress bar cannot be accurately represented as a number.
For example, a slider might display values of small, medium, and large. In this case, the values of aria-valuenow could range from 1 through 3 to indicate the position of the slider, and the aria-valuetext could contain the equivalent size value to present to the user.
If the aria-valuetext attribute is set, authors should also set the aria-valuenow attribute, unless that value is unknown (for example, on an indeterminate progressbar).
Authors should only set the aria-valuetext attribute when the rendered value cannot be meaningfully represented as a number. For example, a slider may have rendered values of small, medium, and large. In this case, the values of aria-valuenow could range from 1 through 3, which indicate the position of each value in the value space, but the aria-valuetext would be one of the strings: small, medium, or large.
If aria-valuetext is specified, assistive technologies should render that value instead of the value of aria-valuenow. If the aria-valuetext attribute is absent, the assistive technologies will rely solely on the aria-valuenow attribute for the current value.
Syntax
<element aria-valuetext="..." ... />
Microsoft Active Accessibility Properties:
- get_accValue
Note: when both aria-valuenow and aria-valuetext aria properties are set, get_accValue will hold the data from the aria-valuetext property.
UI Automation Properties:
- ValueProperty (Value Pattern)
Note: RangeValue and Value Pattern can coexist with UI in case both aria-valuetext and aria-valuenow are specified.
UI Automation AriaProperties Property:
- valuetext