What the standard says
For user interface components with labels that include text or images of text, the name contains the text that is presented visually.
Why it matters
Voice-control users say what they see. If the button reads "Send" but its accessible name is "Submit form", saying "click Send" does nothing.
What a failure looks like
- failsA button labelled "Search" with `aria-label="Submit"`.
- failsAn `aria-label` that replaces the visible text instead of extending it.
How to fix it
- doStart the accessible name with the visible text: `aria-label="Search products"` on a button reading "Search".
- doBetter still, do not override a visible label at all.
How A11ySignal checks it
1 automated check runs against this criterion on every scan.
seriouslabel-content-name-mismatchElements must have their visible text as part of their accessible name