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

BCD tables only load in the browser