元素:ariaAtomic 屬性

Baseline 2023
新推出

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

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

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

"false"

輔助技術將只呈現已更改的節點。

"true"

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

示例

在此示例中,ID 為 "clock" 的元素的 aria-atomic 屬性設定為 "true"。我們使用 ariaAtomic 將其值更新為 "false"。

html
<div id="clock" role="timer" aria-live="polite" aria-atomic="true"></div>
js
let el = document.getElementById("clock");
console.log(el.ariaAtomic); // true
el.ariaAtomic = "false";
console.log(el.ariaAtomic); // false

規範

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

瀏覽器相容性