Select Components

Select (Dropdown)

A single- or multi-select dropdown with configurable options.

Parameters

• Label: Text label shown above the dropdown.

• Placeholder: Text shown when no option is selected.

• Select type: Choose between Single-select or Multi-select.

• Options: Add, remove, or rename options; set default values.

• + Add option: Adds a new choice.

• Reset defaults: Clears pre-selected options.

• Width: Defines the dropdown width.

• Required: Field is mandatory if enabled.

• Exclude from export: Prevents value from appearing in form outputs.

• Add info icon: Shows a tooltip icon with help text.

Functions

• getValue(path) – Returns selected value(s).

• setValue(path, value) – Sets a single string or list of strings depending on select type.

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, value) – Fired on value change.
  Single-select: value: str
  Multi-select: value: List[str]

Checkbox

Displays multiple selection options as a checklist.

Parameters

• Label

• Options: Add/remove options and set defaults.

• Layout: Choose between vertical list or horizontal wrap.

• + Add option / Reset defaults

• Required, Width, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, List[str])

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, List[str])

Radio

Displays a single-choice question with multiple options.

Parameters

• Label

• Options: Add/remove/rename; set default.

• Layout: Vertical or horizontal

• + Add option / Reset defaults

• Required, Width, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, str)

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, str)

Slider

Allows users to pick a numeric value using a sliding scale.

Parameters

• Label

• Min value / Max value: Define the range.

• Step: Controls increments.

• Suffix: Optional label after the number (e.g. %, pts).

• Width, Required, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, int | float)

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, value)
  (value may be a number or list depending on range usage)

Voting

Binary approval component (e.g. Yes/No, Approve/Reject).

Parameters

• Label

• Required, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, int) (0 or 1)

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, int)

Rating

Captures user feedback using a 1–N star scale.

Parameters

• Label

• Number of stars

• Required, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, int)

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, int)

Date Picker

Lets users select a calendar date, with optional time.

Parameters

• Label

• Include time: Adds a time picker to the component.

• Width, Required, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, str) (ISO 8601 date or datetime)

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, str)

Time Picker

Captures time-only inputs (no date).

Parameters

• Label

• Width, Required, Exclude from export, Add info icon

Functions

• getValue(path)

• setValue(path, str) (e.g. "14:30")

• disable(path) / enable(path)

Events

• on_<component_id>_change(path, str)