Skip to content

Radio List

RadioList displays one selectable item from its data source. It uses the shared list-control ValueXPath, CaptionXPath, MappingXPath, data-source, and monitored-XPath behavior.

XML Fields

Binding and Choice Source

  • XPath identifies the control context. ValueXPath selects the chosen item value written to the form data; CaptionXPath optionally stores its displayed text. MappingXPath identifies additional selected-item fields to copy.
  • DataSources supplies choices. MonitoredXPaths lists data paths that reload those choices, and CacheDataSources controls whether source results are reused.

Presentation and Validation

  • Layout selects Horizontal or Vertical arrangement and Size controls width.
  • RequiredForGroup requires a valid choice during matching grouped validation. Hints provides help text and Rules contains conditional formatting or validation.

Selection Behavior

When the current value does not match an available option after a refresh, RadioList selects the first valid option. The selected item's value is written to the value binding, its displayed text is written to CaptionXPath when set, and configured mappings are applied. Design data displays a single empty option when no source items are available.

Set Layout to Horizontal (default) or Vertical; Size uses the standard Small/Medium/Big/Large layout values. In read-only state, the control shows the caption binding when available, otherwise the selected value.

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
<RadioList XPath="Request/Priority" RequiredForGroup="" CacheDataSources="True" Layout="Vertical" Size="Medium">
    <ValueXPath><![CDATA[Value]]></ValueXPath>
    <CaptionXPath><![CDATA[Caption]]></CaptionXPath>
    <MappingXPath><![CDATA[]]></MappingXPath>
    <DataSources>
        <ListItemDataSource TextFormat="{{Text}}" ValueFormat="{{Value}}">
            <Items>
                <Item><Text>Normal</Text><Value>Normal</Value></Item>
                <Item><Text>Urgent</Text><Value>Urgent</Value></Item>
            </Items>
        </ListItemDataSource>
    </DataSources>
    <MonitoredXPaths />
    <Hints><![CDATA[]]></Hints>
    <Rules />
</RadioList>