The Select Widget properties panel contains settings that control the dropdown options, selection behavior, validation, and appearance.
General
| Property | Description |
|---|
| Label | The visible label displayed above or beside the dropdown. |
| Name | Internal field name. Used for data binding and referencing the widget in logic or scripts. |
| Placeholder | Hint text displayed inside the field when no option is selected. |
| Required | Marks the field as mandatory. Validation fails if no option is selected when the form is submitted. |
| Required Message | Custom validation error message shown when the field is required but empty. |
| Readonly | Makes the dropdown non-interactive. The current value is displayed but cannot be changed. |
| Visible | Controls whether the dropdown is displayed. When unchecked, the widget is hidden but remains configured. |
Options
| Property | Description |
|---|
| Options | The list of selectable items. Each option has an ID (stored value) and a Label (displayed text). Options are configured directly in the properties panel. |
| Multiple Selection | When enabled, the user can select more than one option. All selected IDs are stored as a single string joined with the ¤ separator character. |
| Enable Search | Displays a text input inside the dropdown panel for filtering visible options by typing. |
Appearance
| Property | Description |
|---|
| Display Type | Controls how the selected value is shown inside the closed field: Dropdown displays the selected label as text; Chip displays each selected value as a removable chip/tag (recommended when using multiple selection). |
| Size | Sets the visual size of the dropdown field: Small, Medium, or Large. |
| Variant | Sets the visual style of the field: Outlined (border around the field), Filled (shaded background), or Standard (bottom border only). |
| Font Size | Overrides the font size defined in the project theme. |
| Font Weight | Overrides the font weight defined in the project theme. |
Advanced
| Property | Description |
|---|
| On Change Handler | When enabled, the widget fires an onChange event to the backend when a selection is made and the dropdown closes. See Select Events. |
| Force Readonly | Forces the field to be read-only when an existing record is being edited, regardless of the overall form state. |
| Ignore Readonly | Overrides the Readonly setting. Allows the field to remain interactive even if the form or parent container is set to read-only. |