Select Events
The Select Widget can fire an onChange event to the backend when a selection is made. This behavior must be explicitly enabled per field.
Enabling the onChange Event
Enable the On Change Handler property in the widget's Properties Panel to activate event dispatching.
Event Details
onChange
Fired when the user makes a selection and the dropdown closes.
The backend receives a request containing:
| Field | Description |
|---|---|
widgetName | The internal name of the select field. |
widgetValue | The ID of the selected option. For multiple selection, a ¤-separated string of all selected IDs. |
widgetEvent | Always "onChange" for this event. |
The backend uses widgetName and widgetEvent to identify the source field and the event type, then returns an appropriate response (e.g., update another field, load dependent data, show or hide other widgets).
Event Timing
The onChange event fires when the dropdown panel closes after the user has finished their selection — not on each individual click within the dropdown. This means:
- For single selection: fires once after the user picks an option and the dropdown closes
- For multiple selection: fires once after the user finishes all selections and closes the dropdown