Текст с обработчиком click может выглядеть как команда и оставаться обычным текстом для вспомогательной технологии. Для действия в текущем интерфейсе предпочтите нативную кнопку, затем проверьте её доступное имя и клавиатурную работу. Если элемент ведёт на другую страницу, сначала разберите назначение: это может быть ссылка, а не кнопка.
Возьмите одно безвредное тестовое действие, например пересчёт искусственного результата. Пройдите к элементу клавишей Tab, выполните его через Enter и Space и сравните с мышью. До замены отметьте число срабатываний обработчика. После миграции старые клавиатурные обработчики могут остаться и запускать ту же команду второй раз.
Роль не равна внешнему виду
Паттерн Button в W3C APG описывает кнопку как элемент с ролью button и доступным именем. При фокусе её активируют Enter и Space; расположение фокуса после действия зависит от изменения контекста. Источник проверен 13 октября 2026 года. Рекомендация начинать с нативного элемента сокращает собственную логику, но не отменяет проверку конкретного компонента.
Условная команда без отправки формы:
<button type="button">Пересчитать итог</button>
Обработчик прикладного действия подключается
один раз; результат проверяется на стенде.
Для отправки формы назначение выбирают отдельно.В инспекторе сравните исходный элемент и итоговую роль в дереве доступности. Затем прочитайте имя без визуального соседства. Одно слово «Выполнить» может не объяснять действие, если рядом несколько команд. Не используйте имя внутренней функции как пользовательскую подпись: оно понятно коду, а человеку нужно понять ожидаемый результат.
Миграция может оставить два пути одного действия
| Контроль | Что наблюдаем | Подозрительный признак |
|---|---|---|
| Мышь | Одно прикладное действие | Два обработчика на родителе и кнопке |
| Enter | Одну активацию команды | Старый keydown и новое штатное поведение |
| Space | Команду без неожиданного эффекта | Прокрутка вместо действия или повтор |
| Элемент внутри формы | Согласованный сценарий | Нежелательная отправка формы |
Условный случай: div имел обработчик клавиши Enter, который напрямую вызывал сохранение. После замены на button разработчик сохранил этот обработчик и обработчик click. Результат может стать двойным. Найдите единую точку прикладного действия и сверяйте её вызовы; удаляйте устаревший путь только после проверки, какой механизм теперь отвечает за активацию.
Если кнопка находится в форме, явно выберите её тип по назначению. Команда пересчёта и отправка формы — разные действия. Проверка вне формы не выявит непреднамеренную отправку после интеграции в страницу. Не скрывайте эту ошибку отменой всех событий на общей секции: так можно лишить пользователя обычного сценария работы.
Состояние недоступности также должно совпадать с логикой. Внешне тусклый текст может продолжать выполнять действие, а стили нативной кнопки — убрать видимый фокус. Испытайте разрешённое и недоступное состояние отдельно. Если команда запускает асинхронную операцию, повторная активация должна следовать продуктовому правилу, а не просто оставшемуся обработчику.
Проверяем результат команды и положение фокуса
- Прочитать роль и имя в дереве доступности.
- Перейти клавиатурой к кнопке.
- Активировать Enter, затем отдельным тестом Space.
- Сравнить результат и число действий с мышью.
- Проверить фокус после успеха, отказа и изменения контекста.
Если действие открывает диалог, дальнейший фокус проверяется по сценарию диалога. Если только обновляет расчёт, человек должен сохранить понятное место работы. Ошибка запроса не должна удалять активную кнопку и оставлять фокус на исчезнувшем узле без предусмотренного продолжения. Для теста не выполняйте реальные оплаты или удаления.
Применяйте замену сначала в одном компоненте и сравните размеры, переносы и обычное управление мышью. Сохраните ограниченный откат разметки и обработчиков вместе: возврат только тега способен оставить несовместимую логику. Подготовьте для разбора исходный элемент, роль, имя и записи единственной активации. Готовый результат — понятная команда с одинаковым назначением во всех поддерживаемых способах управления.