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 Arten von Aktualisierungen beschreibt, die Benutzeragenten, unterstützende Technologien und Benutzer von der Live-Region erwarten können.

Hinweis: Das Setzen von ARIA-Attributen auf ElementInternals ermöglicht es, Standard-Semantiken auf einem benutzerdefinierten Element zu definieren. Diese können von benutzerdefinierten Attributen überschrieben werden, stellen jedoch sicher, dass die Standard-Semantiken beibehalten werden, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Für weitere Informationen siehe den Accessibility Object Model Erklärer.

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 derzeit diese Region.

"polite"

Gibt an, dass Aktualisierungen der Region 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 der Wert von ariaLive auf "assertive" gesetzt.

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaLive = "assertive";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität