aria-describedby
全局 aria-describedby
属性标识描述设置该属性的元素的元素(或元素)。
描述
aria-describedby
属性列出描述对象的元素的 id
。它用于建立小部件或组与描述它们文本之间的关系。
aria-describedby
属性并不局限于表单控件。它还可以用于将静态文本与小部件、元素组、带有标题的区域、定义等关联。aria-describedby
属性可以与语义 HTML 元素和具有 ARIA role
的元素一起使用。
aria-describedby
属性与 aria-labelledby
属性非常相似。虽然 aria-labelledby
列出描述对象本质的标签或元素的 id
,但 aria-describedby
列出描述或元素的 id
,这些描述或元素提供用户可能需要的更多信息。aria-labelledby
和 aria-describedby
都引用其他元素来计算文本替代方案,但标签应该简洁,而描述旨在提供更详细的信息;标签描述对象的本质,而描述提供用户可能需要的更多信息。
通过 aria-describedby
链接的元素不需要可见。即使元素被隐藏,也可以引用该元素。例如,表单控件可以有一个默认情况下隐藏的描述,该描述可以使用类似于“更多信息”图标的公开小部件在请求时显示。有视觉障碍的用户会点击该图标;对于辅助技术用户,描述会通过 aria-describedby
直接从该表单字段中引用。
当关联内容包含作为纯文本体验的描述时,aria-describedby
属性适用。如果内容包含大量内容、有用的语义或具有需要用户导航的复杂结构,请使用 aria-details
。aria-details
允许辅助技术用户访问关联的结构化内容,并提供额外的导航命令,使其更容易理解结构或以更小的部分体验信息。
注意:aria-describedby
内容应该只是一个文本字符串。如果内容中存在重要的底层语义,请考虑使用 aria-details
。
示例
<button aria-describedby="trash-desc">Move to trash</button>
…
<p id="trash-desc">
Items in the trash will be permanently removed after 30 days.
</p>
注意:aria-describedby
属性并非旨在引用来自外部资源的描述。由于其值为一个或多个 id
(如果多个则以空格分隔),因此它必须引用同一 DOM 文档中的元素。
值
- ID 引用列表
-
描述当前元素的元素
id
或以空格分隔的元素id
列表。
关联角色
用于 所有 角色。也可用于所有 HTML 元素。
规范
规范 |
---|
可访问的富互联网应用程序 (WAI-ARIA) # aria-describedby |
可访问的富互联网应用程序 (WAI-ARIA) # aria-describedby |