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

瀏覽器相容性