ElementInternals: ariaLabel-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 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 |