ElementInternals: ariaLive 屬性
ElementInternals 介面的 ariaLive 屬性反映了 aria-live 屬性的值,該屬性指示元素將要更新,並描述了使用者代理、輔助技術和使用者可以從即時區域期望的更新型別。
注意:在 ElementInternals 上設定 ARIA 屬性允許為自定義元素定義預設語義。這些預設語義可能會被作者定義的屬性覆蓋,但可以確保在作者刪除或根本未新增這些屬性時,預設語義仍然保留。有關更多資訊,請參閱 Accessibility Object Model explainer。
值
一個字串,其值可能為以下之一:
"assertive"-
指示區域的更新具有最高優先順序,應立即呈現給使用者。
"off"-
指示除非使用者當前將焦點放在該區域,否則不應將該區域的更新呈現給使用者。
"polite"-
表示該區域的更新應在下一次合適的機會呈現,例如在說完當前句子時或使用者暫停輸入時。
示例
在此示例中,ariaLive 的值設定為 "assertive"。
js
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaLive = "assertive";
}
// …
}
規範
| 規範 |
|---|
| 無障礙富網際網路應用程式 (WAI-ARIA) # dom-ariamixin-arialive |
瀏覽器相容性
載入中…