Статус: авторский каталог и учебный стенд. Это не результат проверки конкретного продукта и не независимая приемка примеров. Примеры WAI-ARIA Authoring Practices Guide (APG) (внешняя ссылка, откроется в новой вкладке) показывают модели реализации, но сами по себе не подтверждают соответствие WCAG или совместимость со всеми сочетаниями браузеров и вспомогательных технологий.
Как читать карточки
Каждая карточка описывает один компонент как последовательность наблюдаемых состояний. Проверка должна отвечать на четыре вопроса:
- Какое состояние было до действия?
- Какое действие выполнил человек?
- Что изменилось визуально, программно и в положении фокуса?
- Что подтвердили автоматика, ручная проверка и реальная вспомогательная технология?
Для каждого прогона записывают компонент, состояние и задачу, версию продукта, браузер, ОС и вспомогательную технологию, настройки, шаги, ожидаемый и наблюдаемый результат, дату, исполнителя и доказательство. Дословная фраза синтезатора не задается как универсальный эталон: проверяется переданный смысл и возможность выполнить действие.
Рабочая основа: Методология разработки доступных сайтов и Протоколы проверок WCAG 2.2 уровня A и AA. Общие нормативные основания: WCAG 2.2, критерий 2.1.1 «Клавиатура» (внешняя ссылка, откроется в новой вкладке), 2.4.3 «Порядок фокуса» (внешняя ссылка, откроется в новой вкладке), 2.4.7 «Видимый фокус» (внешняя ссылка, откроется в новой вкладке), 2.5.3 «Метка в имени» (внешняя ссылка, откроется в новой вкладке), 2.5.8 «Минимальный размер цели» (внешняя ссылка, откроется в новой вкладке) и 4.1.2 «Имя, роль, значение» (внешняя ссылка, откроется в новой вкладке).
C-01. Кнопка
Открыть исправный пример C-01.
Назначение и граница. Кнопка выполняет действие: отправляет форму, открывает диалог, меняет настройку или запускает операцию. Переход к другому адресу обычно является ссылкой. Исходная модель: Button Pattern в W3C APG (внешняя ссылка, откроется в новой вкладке).
Состояния и действия. Минимальный набор: доступна, в фокусе, активирована, недоступна. Для переключателя добавляются pressed и not pressed; для длительного действия могут понадобиться ожидание, успех и ошибка. Состояние до действия и после него фиксируется раздельно.
Клавиатура. Кнопка получает фокус в логичном порядке и активируется Enter и Space. После действия фокус остается на кнопке либо переходит в новое место, которое соответствует результату: внутрь открытого диалога, к началу нового шага или к логичному продолжению после удаления объекта.
Дизайнер:
- различает действие и переход по ссылке;
- задает постоянную видимую подпись, видимый фокус, состояния недоступности, ожидания и результата;
- показывает размер всей зоны активации, а не только пиктограммы;
- описывает ожидаемое место фокуса после каждого действия.
Разработчик:
- предпочитает нативный
<button>и задает корректныйtype; - включает текст видимой подписи в доступное имя; одного семантического сходства недостаточно по WCAG 2.2, критерию 2.5.3 «Метка в имени» (внешняя ссылка, откроется в новой вкладке);
- обновляет программное состояние переключателя вместе с визуальным;
- блокирует непреднамеренную повторную отправку, не скрывая причину ожидания.
Проверяющий:
- находит кнопку клавиатурой, видит фокус и активирует обеими стандартными клавишами;
- проверяет имя, роль, состояние и результат до и после действия;
- проверяет мышь, касание и голосовое управление по видимой подписи, если они входят в область проверки;
- повторяет действие в состояниях ошибки, ожидания и недоступности.
Ожидание при ручной проверке с экранным доступом. Человек получает понятное имя и роль кнопки. Для переключателя доступно текущее состояние, а после активации оно меняется согласованно. Результат действия обнаружим без поиска по всей странице.
Граница автоматизации. Можно обнаружить часть ошибок имени, роли, фокусируемости, размера цели и значений ARIA (спецификация консорциума W3C для разметки доступности сложных интерфейсов). Автоматика не подтверждает, что действие соответствует подписи, новое место фокуса логично, сообщение понятно или фактическое объявление вспомогательной технологии не потерялось.
C-02. Форма с валидацией
Открыть исправный пример C-02.
Назначение и граница. Карточка охватывает поля, группы, инструкции, валидацию, отправку, ошибку и успешное завершение как один маршрут. Основа реализации: W3C WAI Forms Tutorial (внешняя ссылка, откроется в новой вкладке) и раздел User Notification (внешняя ссылка, откроется в новой вкладке).
Состояния и действия. Пустая форма, ввод, неверное значение, отправка с ошибкой, исправление, повторная отправка, ожидание, успех или ошибка сервиса. Для многошаговой формы добавляются текущий шаг, общее число шагов, возврат и сохранность данных.
Клавиатура. Поля и действия достигаются в порядке задачи. Нативные элементы сохраняют привычную клавиатурную модель. После ошибки фокус переводится в согласованное место, например к сводке или первому неверному полю, и дальнейший маршрут остается понятным.
Дизайнер:
- оставляет подпись видимой и устойчивой после ввода;
- размещает формат, обязательность и ограничения до того, как они понадобятся;
- группирует связанные поля и различает подсказку, ошибку и общий итог;
- проектирует исправление без потери остальных введенных данных.
Разработчик:
- связывает подпись, поле, инструкцию и ошибку программно;
- использует подходящие типы,
autocompleteи нативные группы там, где они подходят; - не обозначает ошибку только цветом и обновляет программное состояние после исправления;
- не создает повторяющееся объявление на каждый вводимый символ без необходимости.
Проверяющий:
- инвентаризирует все видимые и невизуальные инструкции, форматы и условия;
- проходит правильный сценарий и заранее определенный отрицательный сценарий;
- вызывает ошибку, находит ее, переходит к полю, исправляет значение и повторно отправляет;
- проверяет сохранность остальных данных, предупреждения о времени и итог операции.
Ожидание при ручной проверке с экранным доступом. При фокусе понятны имя поля, тип, обязательность и нужная инструкция. Ошибка называет поле и причину, предлагает способ исправления и остается доступной до исправления. После исправления устаревшая ошибка больше не объявляется как действующая. Требования к ошибкам уточняют 3.3.1 «Идентификация ошибок» (внешняя ссылка, откроется в новой вкладке) и 3.3.2 «Метки или инструкции» (внешняя ссылка, откроется в новой вкладке).
Граница автоматизации. Можно проверить наличие части подписей, групп, обязательности, программных связей и некоторых сообщений. Нужны ручные действия, чтобы подтвердить понятность формата, своевременность ошибки, маршрут исправления, сохранность данных и фактическое объявление в выбранной конфигурации.
C-03. Модальный диалог
Открыть исправный пример C-03.
Назначение и граница. Модальный диалог временно ограничивает взаимодействие своим содержимым. Называть окно модальным можно только тогда, когда фон действительно недоступен всем пользователям. Исходная модель: Dialog (Modal) Pattern в W3C APG (внешняя ссылка, откроется в новой вкладке).
Состояния и действия. Закрыт, открыт с начальным фокусом, взаимодействие внутри, ошибка или ожидание внутри, закрыт с возвращенным фокусом. Для необратимого действия отдельно проектируется безопасное начальное положение фокуса.
Клавиатура. При открытии фокус переходит внутрь. Tab и Shift+Tab обходят элементы диалога и не уходят на фон. Escape закрывает диалог согласно модели APG (руководство консорциума W3C по практикам применения ARIA); в интерфейсе также есть видимое действие закрытия. После закрытия фокус обычно возвращается к инициатору, а если инициатор исчез, переходит к логичному продолжению задачи.
Дизайнер:
- задает видимый заголовок, действие закрытия, начальный фокус и порядок обхода;
- показывает модальность визуально и не помещает обязательное действие только за пределами окна;
- выбирает начальный фокус по содержанию: начало сложного текста, безопасное действие или наиболее вероятное продолжение;
- описывает возврат фокуса после каждого способа закрытия.
Разработчик:
- использует нативный
<dialog>либо полностью реализует имя, роль, модальность и управление фокусом; - делает фон инертным для указателя и клавиатуры, а не только скрытым от дерева доступности;
- не включает сам диалог в скрытый от вспомогательных технологий контейнер;
- возвращает фокус после
Escape, кнопки закрытия, отмены и успешного завершения.
Проверяющий:
- открывает окно с клавиатуры и проверяет точное место начального фокуса;
- выполняет обход вперед и назад, пытается перейти на фон;
- закрывает каждым предусмотренным способом и проверяет новое место фокуса;
- проверяет длинное содержимое, увеличение, ошибку и вложенный диалог, если он поддерживается.
Ожидание при ручной проверке с экранным доступом. Доступны имя и роль окна, начальный контекст не превращается в неразборчивую длинную строку, элементы фона не попадают в рабочий маршрут. После закрытия человек понимает, где продолжить задачу.
Граница автоматизации. Можно проверить часть ролей, имени, aria-modal, видимости, фокусируемости и программных связей. Только сценарий подтверждает удержание и возврат фокуса, инертность фона, правильность начального места и фактическое поведение экранного доступа.
C-04. Вкладки
Открыть исправный пример C-04.
Назначение и граница. Вкладки показывают одну из нескольких связанных панелей. Это составной виджет с одной точкой входа в последовательном порядке и внутренней стрелочной навигацией. Исходная модель: Tabs Pattern в W3C APG (внешняя ссылка, откроется в новой вкладке).
Состояния и действия. Одна вкладка выбрана, остальные не выбраны; фокус может находиться на выбранной или другой вкладке. Следует заранее выбрать ручную или автоматическую активацию и не смешивать их непредсказуемо.
Клавиатура. Tab переводит фокус на выбранную вкладку, следующий Tab выводит из списка к панели или следующему логичному элементу. Left Arrow и Right Arrow перемещают фокус по горизонтальному списку; в вертикальном используются Up Arrow и Down Arrow. При ручной активации Enter или Space выбирает вкладку. Home и End являются дополнительными командами. Автоматическая активация подходит только при отсутствии заметной задержки.
Дизайнер:
- отличает фокус от выбранности и делает оба состояния заметными;
- задает ориентацию, порядок, подписи и поведение при длинных названиях;
- выбирает модель активации с учетом задержки загрузки панели;
- описывает загрузку, ошибку и пустое состояние каждой панели.
Разработчик:
- связывает
tablist,tabиtabpanel, поддерживает имя списка и каждой панели; - обновляет
aria-selected, управляет единственной точкой входа и скрывает неактивные панели согласованно; - не перехватывает вертикальные стрелки у горизонтального списка без причины;
- после динамического удаления вкладки переводит фокус к логичному соседу или продолжению.
Проверяющий:
- входит в список одним
Tab, проходит стрелками с переходом через края; - отдельно наблюдает фокус, выбор и отображаемую панель;
- проверяет ручную или автоматическую активацию, задержку, выход из списка и возврат;
- повторяет маршрут при ошибке загрузки и удалении вкладки, если эти состояния предусмотрены.
Ожидание при ручной проверке с экранным доступом. Доступны имя, роль и выбранность вкладки, связь с показанной панелью и изменение состояния после действия. Положение в группе полезно фиксировать как наблюдение, но не задавать одну дословную фразу для всех программ экранного доступа.
Граница автоматизации. Можно проверить роли, программные связи, значения aria-selected, скрытые панели и часть порядка фокуса. Автоматика не подтверждает удобство модели активации, задержку, объявление смены панели и логичное продолжение после удаления.
C-05. Раскрытие
Открыть исправный пример C-05.
Назначение и граница. Раскрытие состоит из кнопки и управляемой области, которая становится видимой или скрытой. Исходная модель: Disclosure (Show/Hide) Pattern в W3C APG (внешняя ссылка, откроется в новой вкладке).
Состояния и действия. Свернуто, развернуто, повторно свернуто. Если содержимое загружается отдельно, добавляются ожидание, готовность и ошибка.
Клавиатура. Кнопка активируется Enter и Space. После раскрытия фокус обычно остается на кнопке, а новое содержимое появляется в логичном порядке чтения и фокуса. После свертывания скрытые элементы не остаются в последовательном обходе.
Дизайнер:
- делает управляющий элемент визуально похожим на кнопку и показывает состояние;
- использует устойчивую подпись или понятную пару подписей;
- располагает управляемое содержимое рядом с кнопкой в логичном порядке;
- проектирует вложенные раскрытия и длинное содержимое без потери ориентации.
Разработчик:
- использует кнопку и обновляет
aria-expandedпри каждом переходе; - при необходимости связывает кнопку и область через
aria-controls; - синхронно меняет визуальную видимость, дерево доступности и порядок фокуса;
- не оставляет фокус внутри области, которую только что скрыл.
Проверяющий:
- проверяет оба способа активации,
expandedдо и после и повторное закрытие; - проходит новое содержимое в ожидаемом порядке;
- убеждается, что закрытые элементы недостижимы и не объявляются как видимые;
- проверяет возврат в исходный контекст после вложенного действия.
Ожидание при ручной проверке с экранным доступом. Доступны имя и роль кнопки, текущее состояние раскрытия и появившееся содержимое. Повторное закрытие не оставляет человека в скрытой области.
Граница автоматизации. Можно сопоставить кнопку, aria-expanded, управляемую область, видимость и фокусируемые потомки. Нужен ручной маршрут, чтобы подтвердить понятность подписи, порядок чтения, сохранение контекста и фактическое объявление изменения.
C-06. Загрузка и уведомления
Открыть исправный пример C-06.
Назначение и граница. Карточка объединяет выбор файла, ограничения, запуск, ожидание, прогресс, успех, ошибку, отмену, повтор и сообщения о результате. Это последовательность состояний, а не один ARIA-виджет.
Состояния и действия. Файл не выбран, выбран и проверяется, отклонен, готов к отправке, загружается без определенного процента, загружается с прогрессом, завершен, отменен, произошла ошибка, доступен повтор. Уведомления разделяются на обычные статусные и срочные.
Клавиатура. Все действия доступны без указателя. Появление обычного статуса не переносит фокус. Срочное сообщение также не должно самовольно забирать фокус; когда необходимо прервать задачу и получить ответ, применяется отдельный диалог. Модель обычного срочного сообщения описывает Alert Pattern в W3C APG (внешняя ссылка, откроется в новой вкладке).
Дизайнер:
- сообщает допустимые типы, размер и другие ограничения до выбора;
- различает ожидание, определенный прогресс, успех, ошибку, отмену и повтор;
- задает приоритет сообщений и сохраняет существенный результат в доступной истории;
- не полагается только на исчезающий тост, цвет или анимацию.
Разработчик:
- связывает поле выбора с инструкциями и ошибками;
- применяет роль
progressbar(внешняя ссылка, откроется в новой вкладке) только когда она соответствует модели прогресса, обновляет имя и значение без чрезмерных объявлений; - применяет роль
status(внешняя ссылка, откроется в новой вкладке) для обычного результата и рольalert(внешняя ссылка, откроется в новой вкладке) только для срочного сообщения; - управляет
aria-busy, очередью сообщений, отменой и повтором согласованно с фактическим состоянием операции.
Проверяющий:
- выбирает допустимый и недопустимый файл, запускает, отменяет и повторяет загрузку;
- наблюдает неопределенный и определенный прогресс, успех и ошибку;
- вызывает обычное и критическое сообщения почти одновременно и проверяет приоритет, отсутствие потери и доступность истории;
- продолжает ввод во время фонового обновления и проверяет, не прерывается ли работа повторяющимися объявлениями.
Ожидание при ручной проверке с экранным доступом. Ограничения известны до выбора. Изменение состояния обнаружимо без переноса фокуса, прогресс не создает поток бесполезных повторов, а успех или ошибка остаются доступны после исчезновения краткого уведомления. Основание: WCAG 2.2, понимание критерия 4.1.3 «Сообщения о статусе» (внешняя ссылка, откроется в новой вкладке).
Граница автоматизации. Можно проверить часть ролей, имен, значений, программных связей, фокус и наличие сообщений после действия. Нельзя автоматически подтвердить приоритет и своевременность фактических объявлений, отсутствие прерывания речи, понятность ошибки, сохранность данных и удобство повторного действия.
Общая граница вывода
Исправная разметка одного состояния не подтверждает доступность компонента во всех переходах. Автоматическая находка, экспертное решение, ручное наблюдение со вспомогательной технологией и результат пользовательской сессии сохраняются как разные типы доказательств. Карточки становятся основанием для приемки только после появления рабочих примеров, воспроизводимых сценариев и независимой проверки ожидаемых результатов.
Интерактивный стенд
Шесть примеров показывают ожидаемые состояния и переходы. Они не заменяют ручную проверку с выбранными браузером, операционной системой и вспомогательной технологией.
C-01. Переключатель
C-02. Форма с валидацией
Адрес сохранен.
C-03. Модальный диалог
Содержимое после диалога.
C-04. Вкладки
C-05. Раскрытие
C-06. Загрузка и уведомления
Результаты
- Заявка принята
- Документы проверены
- Ответ готовится
