MDN self-hosted library · e01.org

Element: ariaSelected property

DOM

Open notebook · 2 cells web-api-instance-property upstream source

DOM

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.

Value

A string with one of the following values:

  • "true"
  • : The item is selected.
  • "false"
  • : The item is not selected.
  • "undefined"
  • : The item is not selectable.

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

Browser compatibility

See also