document

ARIA-роль для части страницы с содержимым, с которым пользователи вспомогательных технологий взаимодействуют только в режиме чтения.

Время чтения: меньше 5 мин

Это незавершённая статья. Вы можете помочь её закончить! Почитайте о том, как контрибьютить в Доку.

Кратко

Скопировано

Роль структуры документа из WAI-ARIA. Означает, что в этой части страницы находится содержимое, с которым пользователи вспомогательных технологий могут взаимодействовать только в режиме чтения. Обычно это текст.

В HTML нет тега с этой ролью.

Как пишется

Скопировано

Задайте тегу роль document, лучше всего <div> или <span>.

Эта роль пригодится только в редких случаях. Например, когда внутри элемента с ролью application, кроме интерактивных элементов, есть ещё статический текст.

Элементам с ролью document можно задавать все глобальные ARIA-атрибуты.

Как понять

Скопировано

Скринридеры могут работать в нескольких режимах. В режиме чтения они последовательно зачитывают текст страницы. Пользователи могут не только слушать текст, но и быстро перемещаться между заголовками и параграфами с помощью стрелок вверх и вниз.