ARIA:文档结构角色
ARIA 文档结构角色用于为内容部分提供结构描述。
结构性 ARIA 角色最初是为了弥合差距而创建的,以便将尚未在浏览器中完全支持的 HTML5 元素告知辅助技术。有些角色,如 presentation
、toolbar
和 tooltip
,在不存在等效的本地 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 可见内容,它命名(也可能描述) figure 、table 、grid 或 treegrid 。仅在上述 4 个角色中找到。 caption 的 id 通常由 figure 、grid 、table 或 treegrid 的 aria-labelledby 属性引用。禁止的属性: aria-label 和 aria-labelledby 。 |
<caption> <figcaption> |
code 一段代表计算机代码片段的内容。 禁止的属性: aria-label 和 aria-labelledby 。 |
<code> |
删除 标记为已删除或建议删除的内容。 禁止的属性: aria-label 和 aria-labelledby 。 |
<del> |
强调 用于强调或突出内容,但不用于建议重要性。 禁止的属性: aria-label 和 aria-labelledby 。 |
<em> |
figure 图形文档、图像、代码片段或示例文本的容器。 |
<figure> |
heading 页面部分的标题。 需要 aria-level 属性来指示嵌套级别。有关更多信息,请参阅 heading 角色。 |
h1、h2、h3、h4、h5 和 h6 |
图片 构成图像的元素集合的容器。 img 角色的同义词。 |
<img> |
img 构成图像的元素集合的容器。 需要可访问名称。 有关更多信息,请参阅 img 角色。 |
<img> |
插入 标记为已添加的内容或正在建议添加的内容。 禁止的属性: aria-label 和 aria-labelledby 。 |
<ins> |
list 包含 listitem 元素的区域。有关更多信息,请参阅 list 角色 |
<ol> <ul> |
listitem list 或 directory 中的单个项目。必须包含在 list 中(例如 <li> )。有关更多信息,请参阅 listitem 角色。 |
<li> |
mark 为参考或注释目的而标记或突出显示的内容。 有关更多信息,请参阅 mark 角色。 |
<mark> |
meter 已知范围内的标量测量值,或分数。 需要可访问名称。需要 aria-valuenow 。有关更多信息,请参阅 meter 角色。 |
<meter> |
段落 一段内容。 禁止的属性: aria-label 和 aria-labelledby 。 |
<p> |
粗体 重要、严重或紧急的内容。 禁止的属性: aria-label 和 aria-labelledby 。 |
<strong> |
下标 一个或多个下标字符。 仅在省略该角色会改变内容含义时使用。 禁止的属性: aria-label 和 aria-labelledby 。 |
<sub> |
上标 一个或多个上标字符。 仅在省略该角色会改变内容含义时使用。 禁止的属性: aria-label 和 aria-labelledby 。 |
<sup> |
term 带有可选对应定义的词语或短语。 禁止的属性: aria-label 和 aria-labelledby 。有关更多信息,请参阅 term 角色。 |
<dfn> |
时间 有效日期或时间字符串格式,例如特定时间点。 禁止的属性: aria-label 和 aria-labelledby 。 |
<time> |
注意:aria-label
和 aria-labelledby
属性禁止用于 code
、caption
、deletion
、emphasis
、generic
、insertion
、mark
、paragraph
、presentation
、none
、strong
、subscript
、superscript
、suggestion
、term
和 time
,并且仅应用于交互式内容。
规范
规范 |
---|
无障碍富互联网应用程序 (WAI-ARIA) # document_structure_roles |