The accessible name is the programmatically determined name of a user interface element that is included in the accessibility tree.
The accessible name is calculated using the accessible name and description computation.
For native markup languages, such as HTML and SVG, additional information on how to calculate the accessible name can be found in HTML Accessibility API Mappings 1.0, Accessible Name and Description Computation (working draft) and SVG Accessibility API Mappings, Name and Description (working draft).
For more details, see examples of accessible name.
Note: As per the accessible name and description computation, each element always has an accessible name. When no accessible name is provided, the element will nonetheless be assigned an empty (
Note: As per the accessible name and description computation, accessible names are flat string trimmed of leading and trailing whitespace. Notably, it is not possible for a non-empty accessible name to be composed only of whitespace since these must be trimmed.
- Because the accessible name and description computation is not clear about which whitespace are considered, browsers behave differently when trimming and flattening the accessible name. For example, some browsers completely trim non-breaking spaces while some keep them in the accessible name.
- There exists a popular browser which does not perform the same trimming and flattening depending whether the accessible name comes from content, an
aria-labelattribute, or an
- There exists a popular browser which assign no accessible name (
null) when none is provided, instead of assigned an empty accessible name (
- The accessible name and description computation suggest that if an
aria-labelledbyattribute refers to an existing but empty element, the computation should stop and return an empty name without defaulting to the next steps. Several user agents and assistive technologies chose to use the next step in the computation in this case.
Used In Rules: (27)
Audio or video element that plays automatically has a control mechanism
Button has non-empty accessible name
Element with lang attribute has valid language tag
SVG element with explicit role has non-empty accessible name
Form field label is descriptive
Form field has non-empty accessible name
Heading has non-empty accessible name
Iframe elements with identical accessible names have equivalent purpose
Iframe element has non-empty accessible name
Image accessible name is descriptive
Image button has non-empty accessible name
DEPRECATED — Image filename is accessible name for image
Image has non-empty accessible name
Image not in the accessibility tree is decorative
Error message describes invalid form field value
Link is descriptive
Link in context is descriptive
Link has non-empty accessible name
Links with identical accessible names have equivalent purpose
Links with identical accessible names and same context serve equivalent purpose
Menuitem has non-empty accessible name
Content has alternative for visual reference
Object element rendering non-text content has non-empty accessible name
Element with presentational children has no focusable content
Text has minimum contrast
Text has enhanced contrast
Visible label is part of accessible name