Html document: HTMLDocument — Web APIs | MDN

ARIA: роль документа — Доступность

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

Роль document предназначена для верхнего контейнера, содержащего контент, который пользователи вспомогательных технологий могут просматривать в режиме чтения. Полезен только для фокусируемых разделов в сложных составных виджетах или приложениях, документ 9Роль 0004 информирует вспомогательные технологии о контексте чтения обратно в режим чтения: роль документа сообщает вспомогательным технологиям с режимами чтения или просмотра, чтобы использовать режим документа для чтения содержимого, содержащегося в этом элементе.

 

Здесь находится информационный текст.

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

По умолчанию веб-страницы рассматриваются как документы; вспомогательные технологии (AT) переходят в режим просмотра или чтения при входе на новую веб-страницу. Этот режим можно изменить с помощью различных ролей, включая роли виджета и приложения. Роль document возвращает AT в режим просмотра или чтения.

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

Поскольку AT с режимом чтения по умолчанию используют этот режим для всех элементов, за исключением элементов с установленной ролью виджета или приложения, роль документа полезна только для фокусируемых элементов в виджете или приложении, которые следует читать как статический форматированный текст. Добавление

role="document" и tabindex="0" к элементу, содержащему текст в виджете, позволяет пользователю программы чтения с экрана нажимать клавишу Tab, чтобы поместить фокус на элемент документа и читать текст с помощью программы чтения с экрана. читающий курсор.

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

В отличие от роли

статьи , роль document не имеет никакого отношения к другим элементам с ролью документа, она просто имеет отношение к содержащему составному виджету. Статья может иметь связанные статьи.

Связанные роли, состояния и свойства WAI-ARIA

aria-expanded

Включить со значением true или false , если элемент документа является сворачиваемым, чтобы указать, развернут ли документ в данный момент или свернут. Другие значения включают значение по умолчанию undefined , что означает, что документ нельзя свернуть.

табиндекс="0"

Используется, чтобы сделать его фокусируемым, чтобы пользователь вспомогательных технологий мог перейти к нему и сразу начать чтение.

Взаимодействие с клавиатурой

Элемент следует сделать фокусируемым, установив для него tabindex="0" пару атрибут/значение. Таким образом, пользователь может перейти к нему, режим чтения активируется автоматически, и содержимое может быть прочитано сразу.

Обязательные функции JavaScript

Нет, кроме тех, которые требуются для каких-либо атрибутов. Например, если документ является сворачиваемым, то необходимо сохранить состояние и значение aria-expanded .

Примером является Gmail и представление одной беседы. GMail — это веб-приложение. В GMail большинство взаимодействий с пользовательским агентом узурпировано приложением. Однако, когда фокус клавиатуры установлен на начальном заголовке отдельной беседы, содержащей тему беседы, пользователь программы чтения с экрана может использовать команды режима чтения, чтобы читать сообщения, разворачивать или сворачивать их и манипулировать ими. Как только фокус вернется к списку сообщений либо путем нажатия кнопки «Назад», либо нажатием соответствующей клавиши, режим прямого взаимодействия с приложением снова активируется, и пользователь может перейти к другому диалогу в списке с помощью кнопки 9.0079 стрелка клавиш.

Всегда убедитесь, что элемент с ролью документа находится в фокусе, установив для атрибута tabindex значение 0. Это также будет включать его в порядок табуляции.

Дополнительные преимущества

Роль документа — это простой способ косвенного управления поведением вспомогательных технологий путем однозначного указания, что это содержимое, которое пользователь должен читать с помощью стандартных команд чтения с экрана.

Спецификация
Доступные расширенные интернет-приложения (WAI-ARIA)
# документ
  • ARIA: виджет роль
  • ARIA: приложение роль

Обнаружили проблему с содержанием этой страницы?

  • Отредактируйте страницу на GitHub.
  • Сообщить о проблеме с содержимым.
  • Посмотреть исходный код на GitHub.

Хотите принять участие? Узнайте

, как внести свой вклад.

Последний раз эта страница была изменена участниками MDN.

: Элемент метаданных документа (заголовок) — HTML: язык гипертекстовой разметки

HTML-элемент содержит машиночитаемую информацию (метаданные) о документе, такую ​​как его заголовок, сценарии и таблицы стилей.

Примечание: в первую очередь содержит информацию для машинной обработки, а не для чтения человеком. Для информации, видимой человеку, такой как заголовки верхнего уровня и перечисленные авторы, см. <заголовок> элемент.

Этот элемент включает глобальные атрибуты.

профиль
Not for use in new websites."> Устаревший Нестандартный

URI одного или нескольких профилей метаданных, разделенные пробелом.

 

  <голова>
    <метакодировка="UTF-8" />
    
    Название документа
  

 
Категории контента Нет.
Разрешенный контент

Если документ