checkbox
Characteristics
Superclass Role:
- input
Subclass Roles:
- menuitemcheckbox
- radio
Related Concepts:
- HTML input [type="checkbox"]
- option
Required States and Properties:
- aria-checked (state)
Inherited States and Properties:
- aria-atomic
- aria-busy (state)
- aria-controls
- aria-describedby
- aria-disabled (state)
- aria-dropeffect
- aria-flowto
- aria-grabbed (state)
- aria-haspopup
- aria-hidden (state)
- aria-invalid (state)
- aria-label
- aria-labelledby
- aria-live
- aria-owns
- aria-relevant
Name From:
- contents
- author
Accessible Name Required:
- True
Implicit Value for Role:
- Default for aria-checked (state) is false.
A checkable input that has three possible values: true, false, or mixed.
The checkable input that has three states. Checked, unchecked and mixed. In most cases, checked state and unchecked state is observed. The checkbox role is used in a input type radio button. Many checkboxes do not use the mixed value, and thus are effectively boolean checkboxes. For a normal input type checkbox, the screen readers by default behavior announces them as checkboxes. For input type radio buttons, if the authors want to intimate the user as checkbox, the checkbox role can be used.
aria-checked (state) can be used in conjunction with checkbox role. The aria-checked (state) will intimate the user about the state of the checkbox. Aria-checked="true" indicates the checked state of the checkbox and false indicates the unchecked state.
Syntax
<input type="radio" role="checkbox" aria-checked="true" aria-label="Male" />
Microsoft Active Accessibility accRole Property:
- ROLE_SYSTEM_CHECKBUTTON
UI Automation ControlType Property:
- Checkbox
UI Automation AriaRole Property:
- checkbox