Semantics

A menuitem with a checkable state whose possible values are true, false, or mixed.

Additional info from the ARIA specification

Authors MUST ensure elements with role menuitemcheckbox are accessibility children of an element with role menu, menubar, or an element with role group that is an accessibility child of an element with role menu or menubar.

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).

In order to identify that they are related widgets, authors MUST ensure that menu item checkboxes are the accessibility descendants of an element with role menu or menubar. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.

Abstract Role

  • WidgetRepresents a focusable, interactive element.

Content Category

Only Used with Specific Parent Roles

This role must be a direct descendant of one of the following roles:

  • menu
  • menubar
  • group

Allowed Descendants

Phrasing Children Allowed

No interactive content descendants, and no descendants with a tabindex attribute specified.

Note

Children Become Presentational

Browsers automatically apply the presentation role to all descendant elements, so their semantics are not conveyed to assistive technologies.

Usage

Allowed HTML elements

Implicit semantics

  • None

Explicitly allowed

  • a­[href][role=menuitemcheckbox]
  • button[role=menuitemcheckbox]
  • img[role=menuitemcheckbox]
  • input­[type=­checkbox][role=menuitemcheckbox]

Elements that can have any role

  • abbr[role=menuitemcheckbox]
  • address[role=menuitemcheckbox]
  • b[role=menuitemcheckbox]
  • blockquote[role=menuitemcheckbox]
  • canvas[role=menuitemcheckbox]
  • cite[role=menuitemcheckbox]
  • code[role=menuitemcheckbox]
  • custom-element[role=menuitemcheckbox]
  • data[role=menuitemcheckbox]
  • del[role=menuitemcheckbox]
  • dfn[role=menuitemcheckbox]
  • div[role=menuitemcheckbox]
  • em[role=menuitemcheckbox]
  • figure[role=menuitemcheckbox]
  • i[role=menuitemcheckbox]
  • ins[role=menuitemcheckbox]
  • kbd[role=menuitemcheckbox]
  • mark[role=menuitemcheckbox]
  • output[role=menuitemcheckbox]
  • p[role=menuitemcheckbox]
  • pre[role=menuitemcheckbox]
  • q[role=menuitemcheckbox]
  • samp[role=menuitemcheckbox]
  • small[role=menuitemcheckbox]
  • span[role=menuitemcheckbox]
  • table[role=menuitemcheckbox]
  • tbody[role=menuitemcheckbox]
  • tfoot[role=menuitemcheckbox]
  • thead[role=menuitemcheckbox]
  • time[role=menuitemcheckbox]
  • u[role=menuitemcheckbox]
  • var[role=menuitemcheckbox]