ElementInternals: ariaHidden-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 ariaHidden-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-hidden-Attributs wider, welches anzeigt, ob das Element einer Zugänglichkeits-API zugänglich ist.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht die Definition von Standardsemantiken auf einem benutzerdefinierten Element. Diese können von benutzerdefinierten Attributen überschrieben werden, aber es wird sichergestellt, dass die Standardsemantiken erhalten bleiben, falls der Autor diese Attribute löscht oder sie gar nicht hinzufügt. Für weitere Informationen siehe die Accessibility Object Model Erklärung.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element ist von der Zugänglichkeits-API versteckt.

"false"

Das Element ist der Zugänglichkeits-API zugänglich, als ob es gerendert wäre.

"undefined"

Der versteckte Zustand des Elements wird vom Benutzeragenten bestimmt, basierend darauf, ob es gerendert wird.

Beispiele

In diesem Beispiel wird der Wert von ariaHidden auf "true" gesetzt.

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

Spezifikationen

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

Browser-Kompatibilität