User Controls¶

User control widgets collect input, support selection, and trigger app actions.

They are essential for forms, settings, and interactive flows.

Widget	Description	Usage Tip
`TextField`	Text input with keyboard and masking support	Use for password and search fields
`Button`	Executes an action or script when clicked	Use for navigation and save actions
`Checkbox`	Inputs boolean selection (`true`/`false`)	Use for multi-select options
`Radio`	Allows one selection in a group	Use for mutually exclusive choices
`DropDown`	Selects one item from an expanded list	Saves space for long option lists
`TabBar`	Switches content areas inside one screen	Enable `isScrollable` when tabs are many
`Switch`	Toggles on/off state	Good for settings enable/disable

TextField¶

Property	Description and Tip
`text`	Initial text value. Supports two-way sync with Data Binding.
`keyboardType`	Select input keyboard type such as number, email, or date.
`obscureText`	Enables password masking mode.
`maxLines`	`1` for single line, `null` for auto-expanding multi-line input.
`onChanged`	Callback action triggered on text change.

Property	Description and Tip
`text`	Single text label shown inside the button.
`onClick`	Script function or action to run on click.
`fillColor`	Background color. Transparent color can mimic outlined or text-button styles.
`icon`	Places image/SVG icon next to text in a configurable direction.
`radius`	Corner radius. `0` is square, high values create pill style.

Property	Description and Tip
`value`	Initial checked state (`true` or `false`).
`activeColor`	Background color when checked.
`borderRadius`	Allows rounded or circular checkbox styling.
`onChanged`	Action on state change. Can bind directly with provider boolean values.

Property	Description and Tip
`groupId`	Radios with the same group ID enforce single selection.
`value`	Unique value for this radio item.
`toggleable`	When `true`, tapping a selected item can clear it.
`onTap`	Action triggered when selected in Lucy Studio.

Property	Description and Tip
`comboType`	Select `combo` (inline) or `sheet` (bottom sheet).
`items`	Items to show. Supports string arrays and JSON formats.
`value`	Current selected value. Supports two-way binding.
`unsetTextColor`	Placeholder text color before selection.

Property	Description and Tip
`tabs`	Add, remove, and reorder tabs via child list.
`isScrollable`	Allows horizontal scroll for long tab sets.
`indicator`	Configure selected-tab indicator color, thickness, and style.
`labelColor`	Set selected and unselected label colors independently.

Property	Description and Tip
`value`	Initial active state (`true` or `false`).
`onChanged`	Action triggered when value changes.