Element: ariaLive-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die ariaLive-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-live-Attributs wider, das angibt, dass ein Element aktualisiert wird, und die Arten von Updates beschreibt, die Benutzeragenten, unterstützende Technologien und der Benutzer von der Live-Region erwarten können.
Wert
Ein String mit einem der folgenden Werte:
"assertive"-
Gibt an, dass Updates in dieser Region höchste Priorität haben und dem Benutzer sofort präsentiert werden sollten.
"off"-
Gibt an, dass Updates in dieser Region dem Benutzer nur präsentiert werden sollten, wenn der Benutzer gerade auf diese Region fokussiert ist.
"polite"-
Gibt an, dass Updates in dieser Region dem Benutzer bei der nächsten günstigen Gelegenheit präsentiert werden sollten, z.B. am Ende des aktuellen Satzes oder wenn der Benutzer eine Pause beim Tippen macht.
Beispiele
In diesem Beispiel wird das aria-live-Attribut auf dem Element mit der ID planetInfo auf "polite" gesetzt. Wir ändern dann den Wert auf "assertive".
<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>
let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // "assertive"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialive |