ElementInternals: ariaOrientation-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 ariaOrientation-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-orientation-Attributs wider, welches angibt, ob die Ausrichtung des Elements horizontal, vertikal oder unbekannt/mehrdeutig ist.

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 jedoch sicher, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Erläuterung.

Wert

Ein String mit einem der folgenden Werte:

"horizontal"

Das Element ist horizontal.

"vertical"

Das Element ist vertikal.

"undefined"

Die Ausrichtung des Elements ist unbekannt.

Beispiele

In diesem Beispiel wird der Wert von ariaOrientation auf "vertical" gesetzt.

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

Spezifikationen

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

Browser-Kompatibilität