kx-selectioncontrols

KX SelectionControls Component

Also read kx-dashboard-core for: envelope, screen/widget wrapper, data sources, ViewState, binding patterns, actions, notifications, and the pre-flight checklist.

⚠️ Hazards — Read First

1. SelectedValue must be a ViewState binding — { "_dashboardsType": "viewstate", "value": "<vsName>" }. A bare string will not publish the selection.
2. MultiSelect: false = radio buttons (single value); MultiSelect: true = checkboxes (multiple values) — declare the ViewState as _type: "symbol" for radio, _type: "list" for checkboxes.
3. ItemActionEvent must be "None" when UseDataSource: true — setting it to "Always" with a data source causes actions to fire on every data update, not just user interaction.
4. UseDataSource: true requires Data and DataSourceMapping — both Value and Text columns must be specified in DataSourceMapping. When false, use the static Items array instead.
5. DoubleClick is only relevant when MultiSelect: true — it is hidden in the properties panel for single-select mode.
6. definitionId is "34" — not "33" (TextInput) or "16" (Dropdown).

SELECTIONCONTROLS

key: "BasicComponents" · definitionId: "34" · ComponentName: "SelectionControls" · version: "v2.9.0"

Radio buttons (single select) or checkboxes (multi-select). Items can be static or driven from a data source.

Basics

{
  "ComponentName": "SelectionControls",
  "Name": "",
  "Data": "",
  "SelectedValue": { "_dashboardsType": "viewstate", "value": "<viewStateName>" },
  "DataSourceMapping": { "Value": "<value-col>", "Text": "<display-col>" },
  "Items": [
    { "Value": "optionA", "Text": "Option A" },
    { "Value": "optionB", "Text": "Option B" }
  ],
  "Theme": "Dark",
  "Label": "select:",
  "LabelWidth": 75,
  "MultiSelect": false,
  "DoubleClick": false,
  "UseDataSource": false,
  "AcceptEmptyValues": false,
  "ForceSelectedValue": false,
  "ItemActionEvent": "None",
  "ItemsLayout": "Horizontal",
  "horizontal": "Center",
  "vertical": "Middle"
}