Element: ariaLabel property
Baseline 2023Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
TheariaLabel property of theElement interface reflects the value of thearia-label attribute, which defines a string value that labels the current element.
Value
A string ornull.
Examples
In this example thearia-label attribute on the element with an ID ofclose-button is set to "Close". UsingariaLabel we update the value to "Close dialog".
html
<button aria-label="Close">X</button>js
let el = document.getElementById("close-button");console.log(el.ariaLabel); // "Close"el.ariaLabel = "Close dialog";console.log(el.ariaLabel); // "Close dialog"Specifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialabel |