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.

ariaAtomic は Element インターフェイスのプロパティで、aria-atomic 属性の値を反映します。これは、aria-relevant (en-US) 属性によって定義された変更通知に基づいて、支援技術が変更された領域をすべて表示するか、部分的に表示するかを示します。

値

文字列で、以下の値のいずれかです。

"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