ElementInternals:ariaRelevant 属性

非标准:此功能是非标准的,并且不在标准轨道上。不要在面向 Web 的生产站点上使用它:它不会适用于每个用户。实现之间也可能存在很大的不兼容性,并且行为将来可能会发生变化。

ariaRelevantElementInternals 接口的一个属性,它反映了 aria-relevant 属性的值,该属性指示用户代理在实时区域内的辅助功能树修改时将触发哪些通知。这用于描述 aria-live 区域中哪些更改是相关的,并且应该宣布。

注意:ElementInternals 上设置 aria 属性允许在自定义元素上定义默认语义。这些可能被作者定义的属性覆盖,但请确保如果作者删除这些属性或根本没有添加这些属性,则保留默认语义。有关更多信息,请参阅 辅助功能对象模型说明

一个字符串,包含以下值之一或多个,用空格分隔

"additions"

应将实时区域内元素节点的添加视为相关。

"removals"

应将节点从实时区域中删除视为相关。

"text"

应将现有节点的文本内容更改视为相关。

"all"

等效于 "additions removals text"

示例

在此示例中,ariaRelevant 的值为“all”。

js
this.internals_.ariaRelevant = "all";

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。