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: (22)
videothat plays automatically has a control mechanism
Button has non-empty accessible name
Link in context is descriptive
svgelement 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
HTML page language subtag matches default language
iframeelements with identical accessible names have equivalent purpose
iframeelement has non-empty accessible name
Image accessible name is descriptive
Image button has non-empty accessible name
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 has non-empty accessible name
Links with identical accessible names have equivalent purpose
Links with identical accessible names and context serve equivalent purpose
Object element rendering non-text content has non-empty accessible name
Text has minimum contrast
Visible label is part of accessible name