kx-textinput

KX TextInput

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

key: "BasicComponents" · definitionId: "33" · ComponentName: "TextInput" · version: "v2.9.0"

A single-line (or multiline) text entry box. The typed value is published to a ViewState via Basics.Text and/or via Actions on Enter/focusout.

Other BasicComponents input controls have their own dedicated skills — use those, not this one:

• kx-button — clickable action trigger (definitionId: "25")
• kx-datepicker — calendar date/time selector (definitionId: "15")
• kx-selectioncontrols — radio buttons / checkboxes (definitionId: "34")

⚠️ Hazards — Read First

1. Basics.Text accepts a ViewState binding — to publish user-typed text to a ViewState use { "_dashboardsType": "viewstate", "value": "<vsName>" }, not a plain string.
2. Actions fire on Enter keypress AND focusout — use them to trigger data source re-execution or ViewState maps after the user types.
3. Type: "multiline" switches the input to a <textarea> — the fixedHeight / height fields control its size.

Basics

{
  "ComponentName": "TextInput",
  "Name": "",
  "Theme": "Dark",
  "Text": { "_dashboardsType": "viewstate", "value": "<viewStateName>" },
  "Type": "text",
  "FontSize": 16,
  "horizontal": "Center",
  "vertical": "Middle",
  "fixedWidth": false,
  "width": 100,
  "fixedHeight": false,
  "height": 100
}