ElementInternals: ariaRoleDescription-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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 |