Element.ariaDisabled

Note

The ariaDisabled property of the Element interface reflects the value of the aria-disabled attribute, which indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.

Where possible use an HTML <input> element with type="button" or the <button> element as these have built in semantics and do not require ARIA attributes.

Syntax

var ariaDisabled = element.ariaDisabled;
element.ariaDisabled = ariaDisabled

Value

A DOMString with one of the following values:

"true"
The element is enabled.
"false"
The element and all focusable descendants are disabled and its value cannot be changed by the user.

Examples

In this example the aria-disabled attribute on the element with an ID of saveChanges is set to "true" indicating that this input is currently disabled. Using ariaDisabled we update the value to "false".

<div id="saveChanges" tabindex="0" role="button" aria-disabled="true">Save</div>
let el = document.getElementById('saveChanges');
console.log(el.ariaDisabled); // "true"
el.ariaDisabled = "false"
console.log(el.ariaDisabled); // "false"

Specifications

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

Browser compatibility

BCD tables only load in the browser