Element: 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 der Element-Schnittstelle spiegelt den Wert des aria-label-Attributs wider, das einen String-Wert definiert, der das aktuelle Element bezeichnet.
Wert
Ein String oder null.
Beispiele
In diesem Beispiel wird das aria-label-Attribut des Elements mit der ID close-button auf "Close" gesetzt. Mithilfe von ariaLabel aktualisieren wir den Wert auf "Close dialog".
html
<button aria-label="Close" id="close-button">X</button>
js
let el = document.getElementById("close-button");
console.log(el.ariaLabel); // "Close"
el.ariaLabel = "Close dialog";
console.log(el.ariaLabel); // "Close dialog"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialabel |
