Accessibility finding
The visible label of a control is not part of its accessible name
Accessibility Error Severity: High
Part of the audit The visible label and the accessible name differ. Finding id: accessibility.labelVsName.
What it costs you
Someone who uses voice control says the words on the screen and the control may not respond, because the name does not contain them as shown.
What to do
Worth checking which text is meant; we assume the visible one. Make the accessible name start with the visible label, word for word, and add any extra words after it. The scanner's guidance applies: [help url]
What it checks
- Spoken name lacks the visible label
- Hidden label replaces visible text
How to fix it
Let the visible text be the name
How to check: Run the scanners on the page again. Then say the visible label to a voice-control tool and see that the control responds.
Thresholds
| Name | Default | Meaning |
|---|---|---|
min_scanners | 2 | How many scanners must report the same control before it counts as a failure. |
other_words_overlap | 0.0 | Word overlap (0 to 1) between visible label and accessible name at or below which the name counts as 'other words'. |
How to verify by hand
A voice-control or screen reader test of the control.
What this relies on
The visible label is what the owner means; the hidden name was written separately.