---
title: "`document`"
description: "ARIA-роль для части страницы с содержимым, с которым пользователи вспомогательных технологий взаимодействуют только в режиме чтения."
url: "https://doka.guide/a11y/role-document/"
section: "Доступность"
authors: ["doka-dog"]
related: ["a11y/aria-intro", "a11y/aria-roles", "a11y/aria-attrs"]
isPlaceholder: true
source: "https://github.com/doka-guide/content/blob/main/a11y/role-document/index.md"
license: "CC BY-NC-SA 4.0"
---

# `document`

## Кратко

[Роль структуры документа](/a11y/aria-roles/#roli-struktury-dokumenta) из [WAI-ARIA](/a11y/aria-intro/#specifikaciya). Означает, что в этой части страницы находится содержимое, с которым пользователи вспомогательных технологий могут взаимодействовать только в режиме чтения. Обычно это текст.

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

## Как пишется

Задайте тегу роль `document`, лучше всего [`<div>`](/html/div/) или [`<span>`](/html/span/).

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

Элементам с ролью `document` можно задавать все [глобальные ARIA-атрибуты](/a11y/aria-attrs/#globalnye-atributy).

## Как понять

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

