Main content

radio

Characteristics

Superclass Role:

  • checkbox
  • option

Subclass Roles:

  • menuitemradio

Related Concepts:

  • HTML input[type="radio"]

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 input in a group of radio roles, only one of which can be checked at a time.

A radio (role) is used for a checkable element when a group of elements are available and only one among them can be checked at a time. All the similar radio elements can be grouped and assigned with radiogroup role. A radio role is owned by radiogroup role.

Usually a radio role is assigned when elements contain few checkable options. Options such as yes or no, male or female, morning, noon, evening or night etc can be assigned with radio role. If the options are more such as states of a country a combobox role should be assigned.

Authors should ensure that elements with role radio are explicitly grouped in order to indicate which ones affect the same value. This is achieved by enclosing the radio elements in an element with role radiogroup. If it is not possible to make the radio buttons DOM children of the radiogroup, authors should use the aria-owns attribute on the radiogroupelement to indicate the relationship to its children.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_RADIOBUTTON

UI Automation ControlType Property: 

  • RadioButton

UI Automation AriaRole Property: 

  • radio
More in this category: « radiogroup progressbar »