ElementInternals: ariaRoleDescription-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 ariaRoleDescription-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-roledescription-Attributs wider, welches eine menschenlesbare, autoren-lokalisierte Beschreibung für die Rolle eines Elements definiert.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals erlaubt es, Standardsemantiken für ein benutzerdefiniertes Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, aber stellen Sie sicher, dass die Standardsemantik beibehalten wird, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model-Erklärer.

Wert

Ein String.

Beispiele

In diesem Beispiel wird der Wert von ariaRoleDescription auf "My custom widget" gesetzt.

js
class CustomEl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaRoleDescription = "My custom widget";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität

Siehe auch