元素：ariaLabel 属性

基线 2023

新可用

自从 2023 年 10 月，此功能适用于最新的设备和浏览器版本。此功能可能不适用于旧设备或浏览器。

ariaLabel 属性 Element 接口反映 aria-label 属性的值，该属性定义一个字符串值，该值标记当前元素。

价值

一个字符串或 null。

示例

在此示例中，close-button ID 的元素上的 aria-label 属性设置为“关闭”。使用 ariaLabel，我们将值更新为“关闭对话框”。

html
<button aria-label="Close" id="close-button">X</button>
js
let el = document.getElementById("close-button");
console.log(el.ariaLabel); // "Close"
el.ariaLabel = "Close dialog";
console.log(el.ariaLabel); // "Close dialog"

规范

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

浏览器兼容性

BCD 表格仅在启用