大网数据广告活动
Web 标准与前端开发

ARIA: document structural roles

· 52CE 我爱测

ARIA document-structure roles are used to provide a structural description for a section of content.

ARIA document-structure roles are used to provide a structural description for a section of content.

Structural ARIA roles were originally created as a bridge to inform assistive technologies of HTML5 elements that were not yet fully supported in browsers. Some roles, like presentation, toolbar and tooltip, provide information on the document structure to assistive technologies in cases where equivalent native HTML elements don't exist. Other roles, including those listed in the table below, are not needed, as there are semantic HTML elements with the same meanings. In many cases, these equivalent HTML elements have always been supported.

[!WARNING] These structural roles all have semantic HTML equivalents. They are included here for completeness of documentation. Preferably, they should not be used by web authors. Opt for HTML semantic elements instead.

Some structural roles, like suggestion, don't have HTML equivalents, and therefore have separate documentation. Some structural roles with HTML equivalents, like heading, have ARIA-attribute requirements. They are listed below with links to their individual role documentation.

Most of the following roles were never needed but were added to ARIA for completeness. We've included them here for completeness as well.

Structural roles with HTML equivalents

The structure roles with HTML equivalents are listed below:

ARIA role & description HTML Equivalent
associationlist <br> Contains only associationlistitemkey children and their sibling associationlistitemvalue. dl
associationlistitemkey <br/> Must be contained in an associationlist. dt
associationlistitemvalue <br/> Always a sibling following an associationlistitemkey. dd
blockquote <br/> A section of content that is quoted from another source. blockquote
caption <br>Visible content that names, and may also describe, a figure, table, grid, or treegrid.<br/> Only found in those 4 roles. A caption's id is generally referenced by a figure, grid, table, or treegrid's aria-labelledby attribute.<br/> Prohibited attributes: aria-label and aria-labelledby. caption <br/> figcaption
code <br/> A section representing a fragment of computer code. <br/> Prohibited attributes: aria-label and aria-labelledby. code
deletion <br/>Content that is marked as removed or suggested for removal.<br/> Prohibited attributes: aria-label and aria-labelledby. del
emphasis <br/> Used to stress or emphasize content, but not to suggest importance.<br/>Prohibited attributes: aria-label and aria-labelledby. em
figure <br/>Container for a graphical document, images, code snippets, or example text. figure
heading <br/> A heading for a section of the page.<br/>The aria-level attribute is required to indicate the nesting level.<br/>See the heading role for more information. Heading_Elements, Heading_Elements, Heading_Elements, Heading_Elements, Heading_Elements, and Heading_Elements
image <br/>Container for a collection of elements that form an image. Synonym for img role. img
img <br/>Container for a collection of elements that form an image. <br/>Accessible name is required. <br/>See the img role for more information. img
insertion <br/>Content that is marked as added or content that is being suggested for addition.<br/> Prohibited attributes: aria-label and aria-labelledby. ins
list<br/>A section containing listitem elements.<br/> See list role for more information ol<br/>ul
listitem<br/>A single item in a list or directory.<br/>Must be contained in a list (like <li>).<br>See listitem role for more information. li
mark<br/>Marked or highlighted for reference or notation purposes.<br>See mark role for more information. mark
meter <br/>A scalar measurement within a known range, or a fractional value.<br/>Accessible name required. aria-valuenow required.<br/>See meter role for more information. meter
paragraph <br/>A paragraph of content.<br/> Prohibited attributes: aria-label and aria-labelledby. p
strong <br/>Important, serious, or urgent content.<br/> Prohibited attributes: aria-label and aria-labelledby. strong
subscript <br/>One or more subscripted characters.<br/>Only use if absence of role would change the content's meaning.<br/> Prohibited attributes: aria-label and aria-labelledby. sub
superscript <br/>One or more superscripted characters.<br/>Only use if absence of role would change the content's meaning.<br/> Prohibited attributes: aria-label and aria-labelledby. sup
term<br/>Word or phrase with an optional corresponding definition.<br/> Prohibited attributes: aria-label and aria-labelledby.<br/>See term role for more information. dfn
time <br> A valid date or time string format list a specific point in time.<br/> Prohibited attributes: aria-label and aria-labelledby. time

[!NOTE] The aria-label and aria-labelledby attributes are prohibited on code, caption, deletion, emphasis, generic, insertion, mark, paragraph, presentation, none, strong, subscript, superscript, suggestion, term, and time, and should only be used on interactive content.

Specifications

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。