ElementInternals: ariaLabel-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 ariaLabel-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-label-Attributs wider, das einen String-Wert definiert, der das aktuelle Element beschreibt.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken für ein benutzerdefiniertes Element festzulegen. Diese können von vom Autor definierten Attributen überschrieben werden, stellen jedoch sicher, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder gar nicht erst hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Explainer.

Wert

Ein String.

Beispiele

In diesem Beispiel wird der Wert von ariaLabel auf "close" gesetzt.

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

Spezifikationen

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

Browser-Kompatibilität