ElementInternals: ariaLive-Eigenschaft
Baseline 2023Newly 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 der ElementInternals-Schnittstelle spiegelt den Wert des aria-live-Attributs wider, welches anzeigt, dass ein Element aktualisiert wird, und beschreibt die Arten von Aktualisierungen, die von den Benutzeragenten, unterstützenden Technologien und Benutzern von der Live-Region erwartet werden können.
Hinweis:
Das Festlegen von aria-Attributen auf ElementInternals erlaubt es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch benutzerdefinierte Attribute überschrieben werden, sichert jedoch, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model erklärt.
Wert
Ein String mit einem der folgenden Werte:
"assertive"-
Gibt an, dass Aktualisierungen der Region die 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 momentan auf diese Region.
"polite"-
Gibt an, dass Aktualisierungen der Region bei der nächsten geeigneten Gelegenheit präsentiert werden sollten, beispielsweise 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