ElementInternals: ariaAtomic 屬性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以來,此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

ElementInternals 介面的 ariaAtomic 屬性反映了 aria-atomic 屬性的值。該屬性指示輔助技術是根據 aria-relevant 屬性定義的更改通知來呈現更改區域的全部內容,還是僅呈現部分內容。

注意:ElementInternals 上設定 ARIA 屬性允許為自定義元素定義預設語義。這些預設語義可能會被作者定義的屬性覆蓋,但可以確保在作者刪除或根本未新增這些屬性時,預設語義仍然保留。有關更多資訊,請參閱 Accessibility Object Model explainer

一個字串,其值可能為以下之一:

"false"

輔助技術將僅呈現更改的節點或節點。

"true"

輔助技術將作為一個整體呈現整個更改區域,包括作者定義的標籤(如果存在)。

示例

在此示例中,在自定義元素的建構函式中將 ariaAtomic 的值設定為 "true"。

js
class MyCustomElement extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaAtomic = "true";
  }
}

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariaatomic

瀏覽器相容性