ElementInternals: ariaLabel-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 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.
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaLabel = "close";
}
// …
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialabel |