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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ariaAtomic

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support