Skip to main content

Textarea Events

The Textarea Widget can fire two types of events to the backend: a standard onChange event when the value changes, and an onGetCustomResponse event for autocomplete suggestions while the user types.


onChange

Fired when the field value is committed and On Change Handler is enabled.

Enabling

Enable the On Change Handler property in the widget's Properties Panel.

Trigger

  • Desktop: fires on blur (when the field loses focus)
  • Mobile: fires on each keystroke

Request

FieldDescription
widgetNameThe internal name of the textarea field.
widgetValueThe current text value of the field.
widgetEventAlways "onChange" for this event.

Request payload example


onGetCustomResponse

Fired while the user types, when Autocomplete is enabled. The backend responds with a list of suggestions displayed below the textarea.

Enabling

Enable the Autocomplete property in the widget's Properties Panel.

Trigger

Fires as the user types in the textarea. The current partial text is sent to the backend.

Request

FieldDescription
widgetNameThe internal name of the textarea field.
widgetValueThe current text entered so far.
widgetEventAlways "onGetCustomResponse" for this event.

Backend Response

The backend should return a CustomResponse with a list of suggestion strings. The widget renders these as selectable options below the input. When the user selects a suggestion, it replaces or appends to the current field value.

info

onGetCustomResponse and onChange are independent. Both can be enabled simultaneously — autocomplete fires while typing, while onChange fires on blur.

Request payload example