元素:ariaRelevant 属性
非标准:此功能是非标准的,不属于任何标准化流程。不要在面向 Web 的生产环境中使用它:它不会对所有用户有效。不同实现之间也可能存在较大差异,行为在将来也可能会改变。
ariaRelevant
属性是 Element
接口的属性,它反映了 aria-relevant
属性的值,该属性指示用户代理在实时区域内的可访问性树发生修改时将触发哪些通知。这用于描述实时区域中哪些更改是相关的,应该进行播报。
值
包含一个或多个以下值的字符串,用空格分隔
"additions"
-
实时区域内添加的元素节点应被视为相关。
"removals"
-
从实时区域中删除的节点应被视为相关。
"text"
-
对现有节点文本内容的更改应被视为相关。
"all"
-
等效于
"additions removals text"
。
示例
在本例中,aria-relevant
属性在 ID 为 text
的元素上设置为“all”。使用 ariaRelevant
我们将值更新为“text”。
html
<div
id="clock"
role="timer"
aria-live="polite"
aria-atomic="true"
aria-relevant="all"></div>
js
let el = document.getElementById("clock");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // text
浏览器兼容性
BCD 表格仅在浏览器中加载