Thearia-checked attribute indicates the current "checked" state of checkboxes, radio buttons, and other widgets.

Description

Thearia-checked attribute indicates whether the element is checked (true), unchecked (false), or if the checked status is indeterminate (mixed), meaning it is neither checked nor unchecked. Themixed value is supported by the tri-state input roles ofcheckbox andmenuitemcheckbox.

Themixed value is not supported onradio,menuitemradio, orswitch and elements that inherits from these. The value will be false ifmixed is set when not supported.

<span  role="checkbox"   aria-checked="false"  tabindex="0"  aria-labelledby="chk15-label"></span><label>Subscribe to the newsletter</label>

Thetabindex attribute is required to enable focus. JavaScript is required to toggle thearia-checked state. And, if this checkbox is part of a submittable form, more JavaScript is required to set a name and a value.

The above could have been written as:

<input type="checkbox" name="Subscribe" /><label for="chk15-label">Subscribe to the newsletter</label>

By using the<input> element withtype="checkbox" instead of ARIA, there is no need for any JavaScript.

Values

false

The element supports being checked but is not currently checked.

true

The element is checked.

mixed

forcheckbox andmenuitemcheckbox only, equivalent toindeterminate, indicating a mixed mode value of neither checked nor unchecked.

undefined (default)

The element does not support being checked.

Associated roles

Used in roles:

• checkbox
• menuitemcheckbox
• menuitemradio
• option
• radio
• switch

Associated interfaces

Element.ariaChecked

TheariaChecked property, part of theElement interface, reflects the value of thearia-checked attribute.

ElementInternals.ariaChecked

TheariaChecked property, part of theElementInternals interface, reflects the value of thearia-checked attribute.

myHTMLElement.ariaChecked = true;

Specifications

See also

• <input type="checkbox">
• <input type="radio">
• aria-pressed
• aria-selected
• Two state checkbox example - w3.org
• Mix-state checkbox example - w3.org