Element.ariaLabel

The ariaLabel property of the Element interface reflects the value of the aria-label attribute, which defines a string value that labels the current element.

Syntax

var ariaLabel = element.ariaLabel;
element.ariaLabel = ariaLabel

Value

A DOMString.

Examples

In this example the aria-label attribute on the element with an ID of close-button is set to "Close". Using ariaLabel we update the value to "Close dialog".

<button aria-label="Close" id="close-button">X</button>
let el = document.getElementById('close-button');
console.log(el.ariaLabel); // "Close"
el.ariaLabel = "Close dialog"
console.log(el.ariaLabel); // "Close dialog"

Specifications

Specification Status Comment
Accessible Rich Internet Applications (WAI-ARIA) 1.2
The definition of 'ariaLabel' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser