aria-description

全局 aria-description 属性定义一个字符串值，用于描述或注释当前元素。

注意：aria-description 仍在 W3C ARIA 1.3 的编辑草案中。目前，请继续使用 aria-describedby，该属性自 ARIA 1.1 起就得到支持。

描述

全局 aria-description 属性提供了一种机制，开发人员可以使用它来描述或注释当前元素，从而为辅助技术用户提供更多上下文。

html
<div
  role="application"
  aria-label="calendar"
  aria-description="Game schedule for the Boston Red Sox 2021 Season">
  <h1>Red Sox 2021</h1>
  <div role="grid">…</div>
</div>

aria-description 属性类似于 aria-label，因为它们都提供一个文本字符串与元素关联，但标签应简短且简洁，而描述可以更长，因为它旨在提供更多上下文和信息。

aria-description 和 aria-describedby 属性具有相同的用途；两者都为用户提供了对其设置的对象的附加描述性文本。如果 DOM 中有描述性文本可用，请改用 aria-describedby。

只有在提供可见描述不是所需的用户体验时，才应使用 aria-description 属性。aria-describedby 属性将其值作为包含有关对象描述性文本的元素的 id 列表。当没有合适的描述性文本可以通过 id 引用与对象关联时，使用 aria-description。如果两个属性都存在，则 aria-describedby 在定义 可访问描述 属性方面优先。

无论由 aria-description 还是 aria-describedby 设置，描述的内容都应为纯文本。如果内容非常长、有语义含义要求或具有导航结构，请改用 aria-details。

值

<字符串>

该值是一个字符串，一个不受约束的值类型，旨在传达给辅助技术用户。

关联接口

Element.ariaDescription

ariaDescription 属性（Element 接口的一部分）反映了 aria-description 属性的值，该属性定义一个字符串值，用于描述或注释当前元素。

关联角色

用于**所有**角色。

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# aria-description

另请参阅