accessibility / label / accessible name
Review label and accessible-name boundaries
Review visible labels, accessible names and descriptions with fixed cases. This guide does not fetch a real DOM or auto-fix ARIA.
Name review matrix
Visible text, the accessible name and supporting description have different roles for assistive technology.
| Case | Visible label | Accessible name | Review point |
|---|---|---|---|
| explicit-label-name | associate label and control | ||
| icon-aria-label | icon only | Search | name the icon button |
| describedby-description | Password | Password | separate supporting description |
| visible-name-difference | Save | Save draft | review visible/name difference |
| missing-name-fail-closed | icon only | undefined | hold a nameless control safely |
Review order
- Check for a visible label.
- Confirm the accessible name uniquely describes the action.
- Keep supporting description separate from the name.
- Do not auto-fix a missing name; decide it before implementation.
Fixed cases only. There is no real DOM, input, external request or ARIA auto-fix.