Accessible name
An accessible name is the programmatically determined text label by which an interface element is identified to assistive technologies.
Architecting Accessibility
An accessible name is the programmatically determined text label that identifies an interface element to users of assistive technologies.
- How it is used
- Identifies links, controls, and forms programmatically so assistive technology users can understand and interact with them.
- How deep it goes
- Explains naming through the accessibility tree and works through native labels, image links, ARIA alternatives, and naming precedence.
- Examples
- Contrasts empty icon links with named links and shows a visibly labeled input and a form named by its heading.
- What you can do after
- Build it from scratch using visible labels and appropriate alternatives, then check that each name communicates its element’s purpose.
Read how Architecting Accessibility explains accessible name →
React in Depth
An accessible name is the programmatically determined text label by which an interface element is identified to assistive technologies.
- How it is used
- Guides accessibility-oriented component tests by locating elements through semantic roles and accessible names.
- How deep it goes
- Defines name sources and demonstrates queries, but defers the complete accessible-name algorithm.
- Examples
- Uses Blog links with text or image alt text and tests a MenuItem rendered with React Testing Library.
- What you can do after
- Apply it via React Testing Library to query elements by role and accessible name instead of presentation-specific selectors.
Related concepts
- aria-labelledbyproduced by · aria-labelledby is a WAI-ARIA attribute that identifies one or more elements whose text provides the accessible name of the element bearing the attribute.
- getByRoleused by · getByRole is a user-interface testing query that locates an element by its accessible role and optionally its accessible name.
- alternative textproduced by · Alternative text is textual content associated with non-text content that conveys its meaningful information or purpose to people who cannot perceive it visually.
- ARIA labelproduced by · The aria-label attribute directly provides an accessible name for an interface element as text.
- label elementimplemented by · The HTML label element associates descriptive text with a form control, identifying its purpose and providing a clickable target for the control.
Questions about accessible name
What is accessible name?
An accessible name is the programmatically determined text label by which an interface element is identified to assistive technologies.
Which Manning books explain accessible name?
Architecting Accessibility and React in Depth.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

