Element: ariaLive-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 ariaLive-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-live-Attributs wider. Dieses Attribut zeigt an, dass ein Element aktualisiert wird und beschreibt die Art der Aktualisierungen, die von Benutzeragenten, Unterstützungssoftware und Benutzern in der Live-Region erwartet werden können.

Wert

Ein String mit einem der folgenden Werte:

"assertive"

Gibt an, dass Aktualisierungen der Region höchste Priorität haben und dem Benutzer sofort präsentiert werden sollten.

"off"

Gibt an, dass Aktualisierungen der Region dem Benutzer nicht präsentiert werden sollten, es sei denn, der Benutzer fokussiert sich gerade auf diese Region.

"polite"

Gibt an, dass Aktualisierungen der Region bei der nächsten passender Gelegenheit präsentiert werden sollten, z.B. am Ende des aktuellen Satzes oder wenn der Benutzer das Tippen unterbricht.

Beispiele

In diesem Beispiel wird das aria-live-Attribut des Elements mit der ID planetInfo auf "polite" gesetzt. Anschließend ändern wir den Wert auf "assertive".

html
<div role="region" id="planetInfo" aria-live="polite">
  <h2 id="planetTitle">No planet selected</h2>
  <p id="planetDescription">Select a planet to view its description</p>
</div>
js
let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // "assertive"

Spezifikationen

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

Browser-Kompatibilität

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
ariaLive

Legend

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

Full support
Full support