ElementInternals: ariaRelevant 属性
非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。
ElementInternals 接口的 ariaRelevant 属性反映了 aria-relevant 属性的值。该属性指示当 live region 内的辅助功能树被修改时,用户代理将触发哪些通知。这用于描述 aria-live 区域中哪些更改是相关的,并且应该被播报。
注意:在 ElementInternals 上设置 ARIA 属性允许为自定义元素定义默认语义。这些默认语义可能会被作者定义的属性覆盖,但可以确保在作者删除或根本未添加这些属性时,默认语义仍然保留。有关更多信息,请参阅 Accessibility Object Model explainer。
值
一个字符串,包含以下一个或多个值,用空格分隔
- "additions"
-
live region 内的 Element 节点的添加应被视为相关。
- "removals"
-
live region 内的节点的删除应被视为相关。
- "text"
-
现有节点的文本内容的更改应被视为相关。
- "all"
-
等同于
"additions removals text"。
示例
在此示例中,ariaRelevant 的值被设置为 "all"。
js
class CustomEl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaRelevant = "all";
}
// …
}
浏览器兼容性
加载中…