Skip to main content
Raasta
SeriousWCAG 4.1.2 · Level Aaria-input-field-name

Custom input has no accessible name

A custom field built with role="combobox", "listbox", "slider", "spinbutton" or "textbox" but no label is announced without saying what it is for. Label it with aria-labelledby pointing at its visible label, or with aria-label if there is none.

Who it hurts

Screen reader users, and voice control users who need a name to move to the field.

Price sliders, size pickers and country lists from plugins and component libraries often ship without a label.

How to fix it

Pick your stack. Review every change before you ship it.

Before

<span>Size</span>
<div role="listbox" class="size-picker">…</div>

After

<span id="size-label">Size</span>
<div role="listbox" aria-labelledby="size-label" class="size-picker">…</div>

Check it by hand too

Tab to each custom field with a screen reader on. You should hear its label, its type and its current value.

Automated checks find a large share of accessibility problems, but not all of them. Passing this check does not on its own make a page compliant.

WCAG reference