Radio buttons API

Radio buttons are used to provide a list of options where only a single option can be selected.

Basic markup

To create a set of radio buttons, add an input with a type="radio" attribute and a corresponding label. Set the for attribute of the label to match the id of the input so they are semantically associated.

Vertical group

To visually integrate multiple radio buttons into a vertically grouped button set, the framework will automatically remove all margins between buttons and round only the top and bottom corners of the set if there is a data-role="controlgroup" attribute on the container.

Horizontal group

Radio buttons can also be used for grouped button sets where more than one button can be selected at once, such as the bold, italic and underline button group seen in word processors. To make a horizontal button set, add the data-type="horizontal" to the fieldset.

Mini size

For a more compact version that is useful in toolbars and tight spaces, add the data-mini="true" attribute to the element to create a mini version.

Icon position

To swap the position of the radio icon from the default position on the left, add the data-iconpos="right" attribute to the fieldset to create a mini version.

Theme

To set the theme, add the data-theme attribute each of the individual checkbox inputs.