Element: ariaChecked property
The ariaChecked
property of the Element
interface reflects the value of the aria-checked
attribute, which indicates the current "checked" state of checkboxes, radio buttons, and other widgets that have a checked state.
Note: Where possible use an HTML <input>
element with type="checkbox"
as this element has built in semantics and does not require ARIA attributes.
Value
A string with one of the following values:
-
"true"
-
The element is checked.
-
"mixed"
-
Indicates a mixed mode value for a tri-state checkbox or menuitemcheckbox.
-
"false"
-
The element supports being checked but is not currently checked.
-
"undefined"
-
The element does not support being checked.
Examples
In this example the aria-checked
attribute on the element with an ID of checkBoxInput
is set to "false" indicating that this input is currently unchecked. Using ariaChecked
we update the value to "true".
<span
role="checkbox"
id="checkBoxInput"
aria-checked="false"
tabindex="0"
aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Remember my preferences</label>
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked);
el.ariaChecked = "true";
console.log(el.ariaChecked);
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
ariaChecked |
81 |
81 |
119 |
No |
68 |
12.1 |
81 |
81 |
119 |
58 |
12.2 |
13.0 |
See also