# Radio Button List

![organizing info](https://4185914948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSItjRhbHaLQ4ar3DUljt%2Fuploads%2Fgit-blob-43cd34fd9bc9f16236f8fb8bee792f56d260ec8d%2Fradio-button-list-web-control-v181-0.png?alt=media)

The Radio List Web Control is an Input control with a repeating component that allows the user to select only one item from a list using Radio buttons.

The Radio List is composed of a [Selectable Container](https://support.airkit.com/v18.0/reference/selectable-container) Web Control which includes a Radio Button and a Label.

## General

### Control Properties

#### Aria Label

Expects type `text`.

Defines a value to the aria-label of the control for accessibility. For more information see [here](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html).

### Data Binding

#### Value

Expects type `any`.

By default, a Variable of type [Any](../variable-data-types/the-any-json-variable-data-type) is generated at the Web Page level to store the data from the input. Users can also edit the Data Binding property and create their own Variables.

#### Data

Expects type `list`.

Each item in the list will have its own item in the Checkbox.

#### Value Text

Expects type

If provided, this is the value stored in the selected objects array, provided in the Selected argument. The entire item will be stored in the list when selected if not provided.

#### Selected

Expects type

This expression is executed on each item in the list to determine whether it is currently selected.

### Advanced Properties

#### Item Name

By default: `item`.

#### Index Name

By default: `index`. This is the number value of the current index of the current item.

#### Collection Name

By default: `items`. This is a variable referring to the entire collection of objects. With the default values set up, `items[index] = item`

### Style and Layout

Check [Common style properties of web controls](web-controls-overview/common-style-properties-of-web-controls) for details on how to style your Radio Button List Web Control.

## Actions

### Value Changed

This event is run each time a radio button within the radio button list is selected.

Metadata about this event can be accessed through the event namespace.

## Advanced

### State

#### Is Visible

Expects type `boolean`. If `TRUE` the radio button list will be visible. If `FALSE` the radio button list will not be displayed. If the field is empty, it will be visible.

#### Is Disabled

Expects type `boolean`. If `TRUE` the radio button list will be disabled and the user will not be able to interact with the control. If `FALSE` the radio button list will enabled. If the field is empty, the radio button list will be enabled.

## Example

This radio list can be created by inserting a Radio Button List and setting the **Data Property** to a List of text. In the Data Binding section, set the Data to the following:

```json

["Colonial", "Ranch", "Barn", "Dutch Colonial", "Modern"]

```

The radio button list will populate with the text values. In Preview, the variable that is bound to the **Value** property will then populate with the selected item that is selected by the user.

![organizing info](https://4185914948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSItjRhbHaLQ4ar3DUljt%2Fuploads%2Fgit-blob-43cd34fd9bc9f16236f8fb8bee792f56d260ec8d%2Fradio-button-list-web-control-v181-0.png?alt=media)
