ElementInternals: ariaLevel-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 ariaLevel-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-level-Attributs wider, das die hierarchische Ebene eines Elements innerhalb einer Struktur definiert.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen aber sicher, dass die Standardsemantiken erhalten bleiben, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model explainer.

Wert

Ein String, der eine ganze Zahl enthält.

Beispiele

In diesem Beispiel wird der Wert von ariaLevel auf "1" gesetzt.

js
class CustomEl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaLevel = "1";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität

Siehe auch