Element: 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 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 |