ElementInternals: ariaLive-Eigenschaft

Die ariaLive-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-live-Attributs wider, das angibt, dass ein Element aktualisiert wird und die Art der Updates beschreibt, die Benutzeragenten, unterstützende Technologien und der Benutzer von der Live-Region erwarten können.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch benutzerdefinierte Attribute überschrieben werden, stellen jedoch sicher, dass Standardsemantiken beibehalten werden, sollte der Autor diese Attribute löschen oder sie überhaupt nicht hinzufügen. Weitere Informationen finden Sie im Accessibility Object Model Explainer.

Wert

Ein String mit einem der folgenden Werte:

"assertive"

Gibt an, dass Updates am Bereich die höchste Priorität haben und dem Benutzer sofort präsentiert werden sollten.

"off"

Gibt an, dass Updates am Bereich dem Benutzer nicht präsentiert werden sollten, es sei denn, der Benutzer ist derzeit auf diesen Bereich fokussiert.

"polite"

Gibt an, dass Updates am Bereich bei der nächsten passenden Gelegenheit präsentiert werden sollten, z. B. am Ende eines gesprochenen Satzes oder wenn der Benutzer das Tippen unterbricht.

Beispiele

In diesem Beispiel wird der Wert von ariaLive auf "assertive" gesetzt.

js
this.internals_.ariaLive = "assertive";

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser