Skip to content

Find what you need, instantly

Search components, ARIA roles & attributes, and WCAG criteria.

All roles

checkbox

Widget role

A control with a checked, unchecked, or mixed (indeterminate) state that the user toggles. Its state is exposed through aria-checked, and it responds to Space. Prefer a native `<input type='checkbox'>`; use the role only for custom checkable widgets.

Used on
A checkable control. Prefer <input type="checkbox"> unless you need a tri-state parent.
Required properties
  • aria-checkedtrue, false, or mixed
Accessible name
Required, via a visible label + aria-labelledby, or aria-label.
Used by components
Example
role="checkbox"
<span role="checkbox" aria-checked="false" tabindex="0">
  Subscribe
</span>
See a live, tested example on the Checkbox (incl. tri-state) page