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