Main content

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
More in this category: « aria-valuenow