ElementInternals: ariaAtomic-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 ariaAtomic-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-atomic-Attributs wider, welches angibt, ob unterstützende Technologien entweder den gesamten geänderten Bereich oder nur Teile davon basierend auf den durch das aria-relevant-Attribut definierten Änderungsbenachrichtigungen präsentieren.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht die Definition von Standardsemantiken auf einem benutzerdefinierten Element. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen aber sicher, dass die Standardsemantiken erhalten bleiben, sollte der Autor diese Attribute löschen oder überhaupt nicht hinzufügen. Für weitere Informationen siehe die Accessibility Object Model Erklärung.

Wert

Ein String mit einem der folgenden Werte:

"false"

Unterstützende Technologien werden nur den oder die geänderten Knoten präsentieren.

"true"

Unterstützende Technologien werden den gesamten geänderten Bereich als Ganzes präsentieren, einschließlich des vom Autor definierten Labels, falls eines existiert.

Beispiele

In diesem Beispiel wird der Wert von ariaAtomic im Konstruktor für ein benutzerdefiniertes Element auf "true" gesetzt.

js
class MyCustomElement extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaAtomic = "true";
  }
}

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser