Element.ariaSelected

The ariaSelected property of the Element interface reflects the value of the aria-selected attribute, which indicates the current "selected" state of elements that have a selected state.

Syntax

var ariaSelected = element.ariaSelected;
element.ariaSelected = ariaSelected

Value

A DOMString with one of the following values:

"true"
The item is selected.
"false"
The item is not selected.
"undefined"
The item is not

Examples

In this example the aria-selected attribute on the element with an ID of tab-id is set to "true". Using ariaSelected we update the value to "false".

<button role="tab" aria-selected="true" aria-controls="tabpanel-id" id="tab-id">Tab label</button>
let el = document.getElementById('tab-id');
console.log(el.ariaSelected); // true
el.ariaSelected = "false";
console.log(el.ariaSelected); // false

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also