Accessible Name Calculation

Accessible Name Techniques

Priority Technique Description
1 aria-labelledby
  • The aria-labelledby attribute contains a list of IDREFs to elements on the page.
  • Text content of referenced elements are concatenated to compute the accessible name.
  • References typically identify visible text on the screen in visual proximity to the control.
2 aria-label
  • The aria-label attribute text content defines the accessible name.
3 Encapsulation using the label element
New in ARIA 1.2
  • Allows the use of the HTML label element to define an accessible name for the following roles:
    • checkbox
    • listbox
    • meter
    • radio
    • searchbox
    • spinbutton
    • switch
    • textbox
4 The legend element for grouping roles
New in ARIA 1.2
Allows the use of the HTML legend element to define the accessible name for the group and gradiogroup roles.
5 text content
  • Some ARIA widget roles allow the text content of the container element to define an accessible name (e.g. role="checkbox").
  • Text content includes text alternatives, for example alt attribute content of an img element.
  • Text content includes text from generated CSS, for example when the content property is used.
6 title
  • If no other source of an accessible name is found and the element has a title attribute, the content of the title attribute will used to define the accessible name.