Skip to content

Selection Controls

Screenshot
Some Radio Buttons

Set up

  1. Use a data source to define the items in the selection control.

  2. Define in the mapping which column represents the text labels in the selection control, and which column is the value passed to the view state on selection.

  3. Set the Selected Value as a view state parameter which carries the value of the selected item.

Basics

Screenshot

Data Source

A data source: include the list of values to pass into the linked View State Parameter and possibly a list of value names to display in the dropdown. For example:

Screenshot
A query for a Radio Button data source

Tip

When using Data Source to create a set of radio buttons, ensure Use Data Source is checked and Data Source Mapping is defined.

A sample query to use is (if connecting to the sample data connection source htmlevalcongroup available in the sample demo dashboard set):

select distinct Asset from FXTradeData
Selected Value

The view state parameter populated on selection.

Selected values

Label
Label description for the Radio Button
Use Data Source
When checked, Data Source is used to build a Radio Button
Accept Empty Values
When checked, a null value is available for selection
Force Selected Value
When checked, the Radio Button will always populate a Selected Value View State Parameter; either default or selected value (which may be null if not set).
Multi-select

When checked, multiple radio button selections are supported and selected items passed to the Selected Value View State Parameter.

Screenshot

Items Layout
Configure Radio Button layout: Horizontal or Vertical
Horizontal
Radio button alignment: Left, Right or Center
Vertical
Radio button alignment: Top, Middle or Bottom
Label Width
Width of the main label

Data source mapping

Screenshot

When a Data Source is used to populate Radio Buttons, the items of the Data Source will represent values. Labels must be assigned using Data Source Mapping – else the list will be empty.

Value
The column of the Data Source corresponding to the values to be passed into the Selected Value View State Parameter
Text
The column of the Data Source corresponding to the text to be displayed as the dropdown options

Items

Screenshot

If Data Source is not used to create Radio Buttons, individual values can be specified in the Items menu.

Action

Actions

Style

Template

Screenshot

Sets the label text for each selection item. The parameters passed to the template depend on whether Use Data Source is enabled.

  • if using a data source then the parameters reflect the column names
  • if inputting items manually then Text and Value parameters are passed

Format, Margins

Style for common settings