Текст рядом с полем ещё не является его подписью. Скринридер получает имя из программной связи, а не из визуальной близости. Если label не связан с input, пользователь услышит только «поле редактирования» или технический placeholder и не поймёт, что вводить.
Разделите три сообщения: короткое имя поля, пояснение формата и текущую ошибку. Когда всё помещают в aria-label, подпись на экране и озвучка начинают расходиться; когда всё помещают в label, каждое возвращение к полю звучит слишком долго.
Базовая связь строится на for и уникальном id
<div class='field'>
<label for='delivery-postcode'>Почтовый индекс</label>
<input
id='delivery-postcode'
name='postcode'
inputmode='numeric'
autocomplete='postal-code'
aria-describedby='postcode-hint postcode-error'
aria-invalid='true'>
<p id='postcode-hint'>Шесть цифр, без пробелов.</p>
<p id='postcode-error'>Проверьте индекс: сейчас пять цифр.</p>
</div>Значение for должно посимвольно совпадать с id, а id — быть уникальным во всём документе. Клик по label должен переводить фокус в поле. aria-describedby перечисляет ID подсказки и ошибки; оно дополняет имя, но не заменяет его. Когда ошибки нет, удалите ссылку на неё или сам текст, чтобы диктор не озвучивал устаревшее сообщение.
Симптом указывает на сломанную связь
| Что слышно | Частая причина | Проверка |
|---|---|---|
| Только «edit text» | Нет accessible name | label[for], id, accessibility tree |
| Только пример из поля | Placeholder используют как label | Добавить постоянную видимую подпись |
| Другая подпись | Дублированный id | Поиск id по всему DOM |
| Подпись дважды | Конкурируют label и ARIA | Вычисленный name и источники |
| Нет подсказки | aria-describedby ссылается в пустоту | Существование элемента в момент фокуса |
| У radio нет вопроса | Нет общей группы | fieldset/legend либо group name |
Accessibility tree в DevTools показывает вычисленное имя и описание, но не заменяет реальный тест. В сложных компонентах id может измениться после hydration, а скрытый label — исчезнуть из accessibility tree из-за display:none. Проверяйте состояние после фактического рендера и после появления ошибки.
Placeholder остаётся примером, а не названием
W3C прямо рекомендует не использовать placeholder вместо label: текст исчезает при вводе, часто имеет низкий контраст и может быть воспринят как уже введённое значение. Хорошая подпись постоянна — «Номер договора», а placeholder при необходимости показывает формат — «AB-123456».
- Не дублируйте одно и то же предложение в label и placeholder.
- Не кодируйте обязательность только звёздочкой без текстового объяснения.
- Общие инструкции разместите до формы, локальные свяжите с полем.
- Не скрывайте label через display:none или visibility:hidden.
- Для визуально скрытого текста используйте проверенный visually-hidden класс.
- Сохраняйте видимую подпись и доступное имя согласованными.
Группа вариантов получает общий вопрос через legend
<fieldset>
<legend>Как получить заказ?</legend>
<label>
<input type='radio' name='delivery' value='courier'>
Курьером
</label>
<label>
<input type='radio' name='delivery' value='pickup'>
В пункте выдачи
</label>
</fieldset>Каждый radio имеет собственную подпись, а legend задаёт вопрос всей группе. Визуальный заголовок над набором div не создаёт эту связь. Если нативный fieldset невозможно использовать в составном widget, роль group/radiogroup и aria-labelledby требуют полноценной клавиатурной модели — это сложнее и должно быть оправдано.
Ошибка сообщает состояние, причину и следующий шаг
После неудачной отправки поставьте aria-invalid=true на конкретное поле, покажите видимый текст ошибки и свяжите его с контролом. В начале формы полезен summary со ссылками к ошибочным полям. Не полагайтесь только на красную рамку. Если сообщение появляется динамически, решите, нужно ли немедленное объявление через live region или достаточно, что оно прозвучит при переводе фокуса.
- Оставить введённое значение, если оно не чувствительное и это безопасно.
- Показать конкретное сообщение рядом с полем.
- Связать сообщение через aria-describedby или подходящий механизм ошибки.
- Перевести фокус в summary либо первое ошибочное поле по согласованному сценарию.
- Дать пользователю исправить значение без повторного ввода всей формы.
- После исправления убрать invalid-состояние и старую связь ошибки.
Ручной проход проверяет фразу, а не наличие атрибута
Пройдите форму только клавиатурой в одном дикторе целевой платформы. Для каждого контрольного поля запишите ожидаемые имя, роль, значение, обязательность, описание и invalid-состояние, затем сравните с фактической фразой. Проверьте пустую форму, заполненное поле, ошибку, исправление и повторный рендер компонента.
| Сценарий | Ожидаемая информация | Провал |
|---|---|---|
| Первый фокус | Имя, роль, обязательность | Только тип поля |
| Поле с форматом | Имя и короткая подсказка | Placeholder исчезает |
| Radio | Общий вопрос и вариант | Слышно только вариант |
| После submit | Имя, invalid и причина | Только цвет рамки |
| После исправления | Обычное состояние | Старая ошибка звучит снова |
| Hydration/SPA route | То же имя и фокус | id изменился или фокус потерян |
Автоматический аудит найдёт часть пропущенных label и дубли id, но не оценит, понятна ли фраза и не повторяется ли она. Готовность подтверждают accessibility tree, keyboard-only сценарий и ручной тест screen reader. Для бага достаточно обезличенного HTML-фрагмента, ожидаемой/фактической фразы, браузера, ОС и версии диктора.