元素:ariaRelevant 属性

基线 2023

新功能

2023 年 10 月起,此功能在最新的设备和浏览器版本中均可使用。此功能可能无法在较旧的设备或浏览器中使用。

非标准:此功能是非标准的,不属于任何标准化流程。不要在面向 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 表格仅在浏览器中加载