Element: ariaAtomic-Eigenschaft

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.

Die ariaAtomic-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-atomic-Attributs wider, welches angibt, ob unterstützende Technologien die gesamte oder nur Teile der veränderten Region basierend auf den Änderungsbenachrichtigungen, die durch das aria-relevant-Attribut definiert sind, präsentieren werden.

Wert

Ein String mit einem der folgenden Werte:

"false": Unterstützende Technologien werden nur den oder die geänderten Knoten präsentieren.
"true": Unterstützende Technologien werden die gesamte veränderte Region als Ganzes präsentieren, einschließlich des vom Autor definierten Labels, falls eines existiert.

Beispiele

In diesem Beispiel wird das aria-atomic-Attribut des Elements mit der ID "clock" auf "true" gesetzt. Mit ariaAtomic aktualisieren wir den Wert auf "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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser