Semantics

A checkable menuitem in a set of elements with the same role, only one of which can be checked at a time.

Additional info from the ARIA specification

Authors MUST ensure elements with role menuitemradio 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.

Authors SHOULD enforce that only one menuitemradio in a group can be checked at the same time. When one item in the group is checked, the previously checked item becomes unchecked (its aria-checked attribute becomes false).

In order to identify that they are related widgets, authors MUST ensure that menu item radios are accessibility descendants of an element with role menu or menubar.

If a menu or menubar contains more than one group of menuitemradio elements, or if the menu contains one group and other, unrelated menu items, authors SHOULD contain each set of related menuitemradio elements in an element using the group role. Authors MAY also delimit the group from other menu items with an element using the separator role, 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=menuitemradio]
  • button[role=menuitemradio]
  • img[role=menuitemradio]
  • input­[type=­radio][role=menuitemradio]

Elements that can have any role

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