Semantics
An element containing content that assistive technology users might want to browse in a reading mode.
Additional info from the ARIA specification
When user agent focus moves to an element assigned the role of document, assistive technologies having a reading mode for browsing static content MAY switch to that reading mode and intercept standard input events, such as Up or Down arrow keyboard events, to control the reading cursor.
Because assistive technologies that have a reading mode default to that mode for all elements except for those with either a widget or application role, the only circumstance where the document role is useful for changing assistive technology behavior is when the element with role document is a focusable accessibility child of a widget or application. For example, given an application element which contains some static rich text, the author can apply role document to the element containing the text and give it a tabindex of 0. When a screen reader user presses the Tab key and places focus on the document element, the user will be able to read the text with the screen reader's reading cursor.
Abstract Role
StructureRepresents a non-interactive part of a page that organizes content into coherent units.
Content Categories
Flow ContentAn element that structures and organizes the body of a web document.
Allowed Descendants
Flow Children Allowed
Usage
Allowed HTML elements
Implicit semantics
- None
Explicitly allowed
article[role=document]embed[role=document]iframe[role=document]object[role=document]section[role=document]
Elements that can have any role
abbr[role=document]address[role=document]b[role=document]blockquote[role=document]canvas[role=document]cite[role=document]code[role=document]custom-element[role=document]data[role=document]del[role=document]dfn[role=document]div[role=document]em[role=document]figure[role=document]i[role=document]ins[role=document]kbd[role=document]mark[role=document]output[role=document]p[role=document]pre[role=document]q[role=document]samp[role=document]small[role=document]span[role=document]table[role=document]tbody[role=document]tfoot[role=document]thead[role=document]time[role=document]u[role=document]var[role=document]