此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaDescription 属性

基线
广泛可用

自 2024年3月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

来自 Element 接口的 ariaDescription 属性反映了 aria-description 属性的值,其定义了一个可以描述或注释当前元素的字符串值。

值

一个字符串。

示例

在这个示例中,拥有 close-button ID 的元素的 aria-description 属性被设置为字符串“关于此元素更详细的描述”。使用 ariaDescription 可以更新该值。

html
<button
  aria-label="关闭"
  aria-description="关于此元素更详细的描述"
  id="close-button">
  X
</button>
js
let el = document.getElementById("close-button");
console.log(el.ariaDescription); // "关于此元素更详细的描述"
el.ariaDescription = "另外一种描述";
console.log(el.ariaDescription); // "另外一种描述"

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariadescription

浏览器兼容性