ElementInternals: ariaRoleDescription-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
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.
class CustomEl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaRoleDescription = "My custom widget";
}
// …
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaroledescription |