ARIA:文档结构角色

ARIA 文档结构角色用于为内容部分提供结构描述。

结构性 ARIA 角色最初是为了弥合差距而创建的,以便将尚未在浏览器中完全支持的 HTML5 元素告知辅助技术。有些角色,如 presentationtoolbartooltip,在不存在等效的本地 HTML 元素的情况下,会向辅助技术提供文档结构的有关信息。其他角色,包括下表中所列的角色,则是不必要的,因为存在含义相同的语义 HTML 元素。在许多情况下,这些等效的 HTML 元素一直都得到了支持。

警告:所有这些结构性角色都有语义 HTML 等效项。此处包含它们是为了文档的完整性。最好不要由 Web 作者使用它们。请优先选择 HTML 语义元素。

某些结构性角色,如 suggestion,没有 HTML 等效项,因此有单独的文档。一些具有 HTML 等效项的结构性角色,如 heading,具有 ARIA 属性要求。它们在下面列出,并附有指向其单独角色文档的链接。

以下大部分角色从未真正需要过,但为了完整性而被添加到 ARIA 中。我们也为了完整性在此包含它们。

具有 HTML 等效项的结构性角色

下面列出了具有 HTML 等效项的结构性角色

ARIA 角色和描述 HTML 等效项
associationlist
仅包含 associationlistitemkey 子元素及其同级的 associationlistitemvalue
<dl>
关联列表项键
必须包含在 associationlist 中。
<dt>
关联列表项值
始终是 associationlistitemkey 后面的同级项。
<dd>
块引用
一段内容,是从其他来源引用的。
<blockquote>
caption
可见内容,它命名(也可能描述)figuretablegridtreegrid
仅在上述 4 个角色中找到。captionid 通常由 figuregridtabletreegridaria-labelledby 属性引用。
禁止的属性:aria-labelaria-labelledby
<caption>
<figcaption>
code
一段代表计算机代码片段的内容。
禁止的属性:aria-labelaria-labelledby
<code>
删除
标记为已删除或建议删除的内容。
禁止的属性:aria-labelaria-labelledby
<del>
强调
用于强调或突出内容,但不用于建议重要性。
禁止的属性:aria-labelaria-labelledby
<em>
figure
图形文档、图像、代码片段或示例文本的容器。
<figure>
heading
页面部分的标题。
需要 aria-level 属性来指示嵌套级别。
有关更多信息,请参阅 heading 角色
h1h2h3h4h5h6
图片
构成图像的元素集合的容器。img 角色的同义词。
<img>
img
构成图像的元素集合的容器。
需要可访问名称。
有关更多信息,请参阅 img 角色
<img>
插入
标记为已添加的内容或正在建议添加的内容。
禁止的属性:aria-labelaria-labelledby
<ins>
list
包含 listitem 元素的区域。
有关更多信息,请参阅 list 角色
<ol>
<ul>
listitem
listdirectory 中的单个项目。
必须包含在 list 中(例如 <li>)。
有关更多信息,请参阅 listitem 角色
<li>
mark
为参考或注释目的而标记或突出显示的内容。
有关更多信息,请参阅 mark 角色
<mark>
meter
已知范围内的标量测量值,或分数。
需要可访问名称。需要 aria-valuenow
有关更多信息,请参阅 meter 角色
<meter>
段落
一段内容。
禁止的属性:aria-labelaria-labelledby
<p>
粗体
重要、严重或紧急的内容。
禁止的属性:aria-labelaria-labelledby
<strong>
下标
一个或多个下标字符。
仅在省略该角色会改变内容含义时使用。
禁止的属性:aria-labelaria-labelledby
<sub>
上标
一个或多个上标字符。
仅在省略该角色会改变内容含义时使用。
禁止的属性:aria-labelaria-labelledby
<sup>
term
带有可选对应定义的词语或短语。
禁止的属性:aria-labelaria-labelledby
有关更多信息,请参阅 term 角色
<dfn>
时间
有效日期或时间字符串格式,例如特定时间点。
禁止的属性:aria-labelaria-labelledby
<time>

注意:aria-labelaria-labelledby 属性禁止用于 codecaptiondeletionemphasisgenericinsertionmarkparagraphpresentationnonestrongsubscriptsuperscriptsuggestiontermtime,并且仅应用于交互式内容。

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# document_structure_roles