ElementInternals: 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 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.
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