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

Data Binding

Value

Expects type any.

By default, a Variable of type Any 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 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:

["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.