AMS DocumentationAMS

Choice Group Item

The Choice Group field allows a user to select one or more options from a range of text values.

The Choice Group control provides a number of options that control the style of the selection widget (e.g. popup menu, radio buttons, switches and checkboxes) and the selections a user can make.

The following screenshot illustrates the configuration of a Choice Group, including the three available options:

Edit Choice Group Field

Choice Type

Description Attributes
Exclusive The user may select only one item from the available choices. This is effectively a radio button style control, with all available options visible at all times and a coloured icon identifying the currently selected item.Selecting an item will have the effect of unselecting any currently selected items.The following screenshot illustrates an Exclusive type Choice Group control (Samsung device, v4.4.2): Radio Button Example

Multiple | The user may select one or more items from the available choices. This is effectively a checkbox style control, with all available options visible at all times and a coloured icon identifying the currently selected item(s).

Selecting an unselected item will select that, in addition to any other items already selected. To unselect an item the user will touch the item a second time.

The following screenshot illustrates a Multiple type Choice Group control (Samsung device, v4.4.2): Multiple Choice Example

Popup | The user may select one item from the available choices. This is effectively a drop-down list box style control, with the selected item visible at all times, and the full list of available options only visible when the list is selected.

Selecting an item will have the effect of unselecting any currently selected items.

The following screenshot illustrates an Popup type Choice Group control when it is in the selected state (Samsung device, v4.4.2): Multiple Choice Example

Settings

Item Description
Label The name of the field that will appear on the screen.
External Label The name of the field when used in XML, Word Document Mail Merge etc
Type Popup: Displayed as popup menu or single selection list. Single selection allowed. Exclusive: Displayed as radio buttons, switch, single selection list or popup menu. Single selection allowed. Multiple: Displayed as checkboxes or selection list. Multiple selections allowed.
Choices A comma separated list of words e.g. ‘one,two,three’. Each item in the list becomes an option. To create choices that contain commas wrap (delimit) each choice in square brackets i.e. [ ]. For example: ‘[low, medium],[high]’ will produce two options: ‘low, medium’ and ‘high’
Layout Horizontally For Exclusive fields on Android devices only, this changes the layout of the radio buttons from vertical to horizontal. This setting is ignored on platforms other than Android.
Display As Switch This setting causes an exclusive choice group field to display as a switch. The field must only have two options otherwise it will display as a normal exclusive choice group field. The first option will become the positive or ‘on’ position for the switch and the second the negative or ‘off’ position for the switch. Since a switch must always have a value, the default is the negative, ‘off’, option.
Is Required Determines if a value must be set for this field.
Validation Type If the field is required this setting determines if it is always required or only when visible.
Visibility Set the visibility options for the field.