WAI-ARIA: Role=MenuitemCheckbox
A menuitem with a checkable state whose possible values are true, false, or mixed.
Description
A menuitem with a checkable state whose possible values are true, false, or mixed.
The aria-checked attribute of a menuitemcheckbox indicates whether the menu item is checked (true), unchecked (false), or represents a sub-level menu of other menu items that have a mixture of checked and unchecked values (mixed).
Authors MUST ensure that menu item checkboxes are owned by an element with role menu or menubar in order to identify that they are related widgets. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.
Role=MenuitemCheckbox Example
HTML Example 1
<li role="menuitemcheckbox" aria-checked="true">Sort by Last Modified</li>HTML Example 2
<ul role="menu">
<li role="menuitem">Console</li>
<li role="menuitem">Layout</li>
<li role="menuitemcheckbox" aria-checked="true">Word wrap</li>
</ul>Characteristics
Superclass Role
- checkbox
- menuitem
Subclass Roles
- menuitemradio
Related Concepts
- menuitem
Required Context Role
- menu
- menubar
Inherited States and Properties
- aria-atomic
- aria-busy (state)
- aria-checked (state) (required)
- aria-controls
- aria-current (state)
- aria-describedby
- aria-details
- aria-disabled (state)
- aria-dropeffect
- aria-errormessage
- aria-flowto
- aria-grabbed (state)
- aria-haspopup
- aria-hidden (state)
- aria-invalid (state)
- aria-keyshortcuts
- aria-label
- aria-labelledby
- aria-live
- aria-owns
- aria-posinset
- aria-readonly
- aria-relevant
- aria-roledescription
- aria-setsize
Name From
- contents
- author
Accessible Name Required
- True
Children Presentational
- True
Implicit Value for Role
- Default for aria-checked is false.
Semantic HTML
No HTML element equivalent.
Reference
- WAI-ARIA 1.2 Specification
Refer to the notes from the WAI-ARIA 1.2 specification for more information on role=menuitemcheckbox.
