Skip to main content

Select Widget Overview

The Select Widget renders a dropdown selector in Buildocs UI Engine. It supports single-value selection, multi-value selection, and an optional search bar for filtering options.

Behavior​

  • Displays a dropdown with a configurable list of options
  • Each option has an internal ID and a visible Label
  • The selected option's ID is stored in the form data
  • Optionally fires an onChange event to the backend when the selection changes (fires when the dropdown closes after a selection is made)

Single vs. Multiple Selection​

ModeBehavior
SingleOne option can be selected at a time. The selected option's ID is stored as a string.
MultipleMore than one option can be selected. All selected IDs are stored as a single string joined with the ¤ separator character.

When Enable Search is active, a text input appears inside the dropdown panel allowing the user to filter the visible options by typing.

Display Type​

The Display Type (Render Type) controls how the selected value is shown inside the field when the dropdown is closed:

TypeDescription
DropdownDisplays the selected label as plain text inside the field
ChipDisplays each selected value as a removable chip/tag (most useful with multiple selection)

Adding to a Row​

  1. Open your form in the Form Builder
  2. Add a Row to the canvas if one is not already in place — see Building Layouts
  3. Locate the Select widget in the component palette
  4. Drag the widget into an empty Row segment
  5. Open the Properties Panel to add options and configure behavior
info

Select widgets must be placed inside a Row segment. They cannot be dropped directly onto the canvas.

Next Steps​