Element: ariaAtomic プロパティ

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年10月以降、すべてのブラウザーで利用可能です。

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

値

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

この例では、ID が "clock" の要素の aria-atomic 属性は "true" に設定されています。ariaAtomic を使用して値を "false" に更新します。

html

<div id="clock" role="timer" aria-live="polite" aria-atomic="true"></div>

let el = document.getElementById("clock");
console.log(el.ariaAtomic); // true
el.ariaAtomic = "false";
console.log(el.ariaAtomic); // false

仕様書
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaatomic

このページは MDN の貢献者によって 2025年4月19日に最終更新されました。