Textarea Widget Overview

The Textarea Widget renders a multi-line text input in Buildocs UI Engine. It is suitable for longer text content such as descriptions, notes, and comments. It optionally supports autocomplete suggestions provided by the backend.

Behavior

• Displays a resizable multi-line text field
• Updates the form value on blur (when the field loses focus), or on each keystroke on mobile devices
• Optionally fires an onChange event to the backend when the value changes
• Optionally fires an autocomplete request to the backend while the user types

Autocomplete

When Autocomplete is enabled, the widget sends an onGetCustomResponse event to the backend as the user types. The backend can respond with a list of suggestions, which are then displayed as selectable options below the field.

This feature is suitable for:

• Smart text completion based on existing records
• Contextual suggestions from a database or API
• Guided data entry to enforce consistent values

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 Textarea widget in the component palette
4. Drag the widget into an empty Row segment
5. Open the Properties Panel to configure the label, validation, and behavior

info

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

Next Steps

• Properties — full reference for all textarea settings
• Textarea Events — details on the onChange and autocomplete events