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";
}
// …
}
瀏覽器相容性
載入中…