Main content

menuitemradio

Characteristics

Superclass Role:

  • menuitemcheckbox (see structure)
  • radio

Related Concepts:

  • menuitem

Required Context Role:

  • group
  • menu
  • menubar

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-checked (state) (required)
  • 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-posinset
  • aria-relevant
  • aria-selected (state)
  • aria-setsize

Name From:

  • contents
  • author

Accessible Name Required:

  • True

Implicit Value for Role:

  • Default for aria-checked (state) is false.

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

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

Authors must ensure that menu item radios are owned by an element with role group, 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.

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 nest each set of related menuitemradio elements in an element using the group role, and authors should delimit the group from other menu items with an element using the separator role.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_RADIOBUTTON

UI Automation ControlType Property: 

  • RadioButton

UI Automation AriaRole Property: 

  • menuitemradio
More in this category: « navigation menuitemcheckbox »