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";
  }
  // …
}

浏览器兼容性