Element: ariaAtomic プロパティ

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

ariaAtomicElement インターフェイスのプロパティで、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

仕様書

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaatomic

ブラウザーの互換性

BCD tables only load in the browser