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-labelledbyaria-describedby 都引用其他元素来计算文本替代方案,但标签应该简洁,而描述旨在提供更详细的信息;标签描述对象的本质,而描述提供用户可能需要的更多信息。

通过 aria-describedby 链接的元素不需要可见。即使元素被隐藏,也可以引用该元素。例如,表单控件可以有一个默认情况下隐藏的描述,该描述可以使用类似于“更多信息”图标的公开小部件在请求时显示。有视觉障碍的用户会点击该图标;对于辅助技术用户,描述会通过 aria-describedby 直接从该表单字段中引用。

当关联内容包含作为纯文本体验的描述时,aria-describedby 属性适用。如果内容包含大量内容、有用的语义或具有需要用户导航的复杂结构,请使用 aria-detailsaria-details 允许辅助技术用户访问关联的结构化内容,并提供额外的导航命令,使其更容易理解结构或以更小的部分体验信息。

注意:aria-describedby 内容应该只是一个文本字符串。如果内容中存在重要的底层语义,请考虑使用 aria-details

示例

html
<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

另请参阅