Input Events
The Input Widget can fire an onChange event to the backend when its value changes. This behavior is optional and 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 for that field.
When enabled, the widget sends an onChange event to the backend each time the value is committed (see Event Timing below).
Event Details
onChange
Fired when the field value is committed and On Change Handler is enabled.
The backend receives a request containing:
| Field | Description |
|---|---|
widgetName | The internal name of the input field. |
widgetValue | The current value of the field. |
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.
Event Timing
The point at which the event is dispatched depends on the active input mode and the device type.
| Mode | Desktop | Mobile |
|---|---|---|
| Text | On blur (when the field loses focus) | On input (on each keystroke) |
| Text with Copy | On blur | On input |
| Date | On blur (after date selection) | On blur |
| Time | On change (immediately after selection) | On change |
| Date & Time | On blur (after selection) | On blur |
| Phone | On blur | On input |
| Currency | On blur | On input |
| Password | On blur | On input |
On mobile devices, most modes update the form value immediately as the user types rather than waiting for the field to lose focus. This ensures the backend receives an accurate value when navigating between fields quickly.
Stored Value Format
Date and time modes always store and send values as ISO 8601 UTC strings, regardless of the display format configured in the properties panel.
| Mode | Stored Format | Example |
|---|---|---|
| Text | Plain string | "Invoice 2024-001" |
| Text with Copy | Plain string | "ABC-123" |
| Date | ISO 8601 UTC | "2024-06-15T00:00:00.000Z" |
| Time | ISO 8601 UTC | "1970-01-01T14:30:00.000Z" |
| Date & Time | ISO 8601 UTC | "2024-06-15T14:30:00.000Z" |
| Phone | Masked string | "(555) 1234-5678" |
| Currency | Numeric string | "1250.00" |
| Password | Plain string | "secret" |