> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Text area

> Capture multi-line input from users for longer responses such as descriptions, comments, or feedback.

![Text area](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/textarea-overview.png)

It is an important tool for creating intuitive and effective conversational interfaces that can collect and process large amounts of user input.

## Configuring the text area element

### Text area generic settings

These settings added in the Generic tab are available and they apply to all platforms including Web, iOS, and Android:

* [**Process data key**](#process-data-key)
* [**Properties**](#properties)
* [**Datasource**](#datasource-configuration)
* [**Validators**](#validators)
* [**Expressions**](#hide/disable-expressions)
* [**Event handlers**](#event-handlers)
* [**Text area styling**](#text-area-styling)

#### Process data key

Process data key creates the binding between form element and process data, so it can be later used in [decisions](https://docs.flowx.ai/6.x/docs/building-blocks/node/exclusive-gateway-node.md), [business rules](https://docs.flowx.ai/6.x/docs/building-blocks/actions/business-rule-action/business-rule-action.md) or [integrations](https://docs.flowx.ai/6.x/docs/building-blocks/node/message-send-received-task-node.md)

#### Properties

* **Label**: The visible label for the text area element.
* **Placeholder**: Text that appears within the text area when it is empty.
* **Has clear**: Option to include a content clear mechanism. The clear icon shows only while the text area has a value and is not disabled.
* **Helpertext**: Additional information about the text area field (can be hidden inside an infopoint).
* **Update on blur**: Update behavior triggered when the text area loses focus.

#### Datasource configuration

The default value for the element can be configured here, this will autofill the text field when you will run the process.

#### Validators

The following validators can be added to a text area: `required`, `minlength`, `maxlength`, `pattern`, `customExpression` and `custom`. For more information, see the [validators documentation](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/validators.md).

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/building-blocks/ui-designer/text_area_props.png)

#### Hide/disable expressions

The text area's behavior can be defined using JavaScript expressions for hiding or disabling the element. The following properties can be configured for expressions:

* **Hide condition**: A JavaScript expression used to hide the text area when it is evaluated to your desired result.
* **Disable condition**: A JavaScript expression used to disable the text area when it returns a truthy value

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/post41/hide_text_area.png)

> [!NOTE]
>
> In the example above, we used a rule to hide a text area element if the value of the switch element above is false.

#### Hide expression example

We will use the key defined on the switch element to create a JavaScript hide condition to hide the text area element:

![Text area hide expression](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/textarea-hide-expression.png)

* Rule used:

```javascript theme={"dark"}
${application.client.hasHouse} === false
```

* Result:

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/post41/text_area_result.gif)

#### Disable example

For example, you can use a disabled condition to disable a text area element based on what values you have on other elements.

![Text area disable expression](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/textarea-disable-expression.png)

When you choose a specific value on the radio element (Contact via SMS), the text area is disabled based on the disabled condition.

* Rule used:

```javascript theme={"dark"}
${application.client.contact} == "prfS"
```

> [!NOTE]
>
> A disabled condition doesn't need a matching hide condition: each one works on its own. Hidden and disabled fields are both left out of validation.

#### Event handlers

Event handlers can be added to the text area field to define its behavior and interactions.

* **Trigger**: **On change** (`CHANGE`).
* **Action type**: Select the type of the action to be performed.

> [!TIP]
>
> For more information, see the [Event Handlers documentation](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/event-handlers.md).

### Text area settings overrides

There are instances where you may need to tailor settings configured in the **Generic** settings tab. This proves especially beneficial when you wish to adjust these settings to appear differently across various platforms such as Web, Android, or iOS.

Available override settings:

* Properties:
  * **Label**: Override the text area label.
  * **Helper**: Override helper text/info point.
  * **Placeholder**: Override the placeholder.
* Expressions:
  * **Hide**: Override the hide expression.

> [!TIP]
>
> To reuse settings overrides on another platform, open the ⋮ menu next to **\<platform> overrides** and pick **Copy from \<platform>** or **Copy to \<platform>**:
>
> ![The ⋮ menu next to Web overrides, listing Copy from Android, Copy from iOS, Copy to Android and Copy to iOS](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/6.x-settings-overrides-copy-menu.png)

### Text area styling

> [tab] Web
>
> > [tab] Sizing
> >
> > #### Fit W (fit width)
> >
> > Adjusting the size of components is crucial for a responsive design. Fit W (width) offers three options:
> >
> > * **Fill**: Fills the available space.
> > * **Fixed**: Maintains a fixed width.
> > * **Auto**: Adjusts the width automatically based on content.
> >
> > #### Fit H (fit height)
> >
> > * **Fixed**: Maintains a fixed height (pixels)
> > * **Auto**: Adjusts the height automatically based on the content.
> >
> > #### Rows
> >
> > Shown only when Fit H is **Auto**. Switching Fit H away from **Auto** clears both values.
> >
> > * **Min rows**: Sets the minimum number of rows.
> > * **Max rows**: Sets the maximum number of rows. Min rows can't be greater than Max rows.
> >
> > By default, the Web text area has a **Fixed** width of 200 and an **Auto** height.
>
> > [tab] Spacing
> >
> > Set the margin (space around the text area) and padding (space inside it) on each side.
>
> > [tab] Grid child
> >
> > Shown only when the text area sits inside a grid container: **Col span**, **Row span**, **Order** and **Alignment** set how the text area is placed in the parent grid.

> [tab] iOS
>
> iOS uses the same Styles sections as web: **Sizing** (Fit W, Fit H, Min rows and Max rows), **Spacing** and **Grid child**. By default, the text area has a **Fill** width and an **Auto** height.
>
> * **fixed height**: Measured in pt - points.

> [tab] Android
>
> Android uses the same Styles sections as web: **Sizing** (Fit W, Fit H, Min rows and Max rows), **Spacing** and **Grid child**. By default, the text area has a **Fill** width and an **Auto** height.
>
> * **fixed height**: Measured in dp - density-independent pixels.

#### Text area style overrides options

Theme overrides refer to the ability to modify or customize the appearance and behavior of UI components by overriding default theme settings. This can be applied at various levels, such as specific elements or entire sections, and can be platform-specific (Web, iOS, Android).

![Text area Theme overrides section in the Styles tab with every override category added](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/textarea-theme-overrides.png)

Style options:

> [accordion] Common Properties
>
> * Border radius **\[NUMBER]**
> * Border width **\[NUMBER]**
> * Font **\[FONT]**

> [accordion] Label
>
> * Default state
>   * Text **\[COLOR]**
> * Disabled state
>   * Text **\[COLOR]**
> * Font **\[FONT]**

> [accordion] Helper
>
> * Text **\[COLOR]**
> * Font **\[FONT]**
> * Helper tooltip
>   * Font **\[FONT]**
>   * Text **\[COLOR]**
>   * Background **\[COLOR]**
>   * Icon **\[COLOR]**

> [accordion] Error
>
> * Text **\[COLOR]**
> * Font **\[FONT]**

> [accordion] Empty state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Placeholder **\[COLOR]**

> [accordion] Active state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**
> * Placeholder **\[COLOR]**

> [accordion] Filled state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**
> * Placeholder **\[COLOR]**

> [accordion] Disabled state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**
> * Placeholder **\[COLOR]**

> [accordion] Error state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**
> * Placeholder **\[COLOR]**

> [accordion] Hover state (only for Web configuration)
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**
> * Placeholder **\[COLOR]**

> [!NOTE]
>
> To reuse theme overrides on another platform without configuring them again, open the ⋮ menu next to **Theme overrides** and pick **Copy from \<platform>** or **Copy to \<platform>**.
>
> ![The ⋮ menu next to Theme overrides, listing Copy from Android, Copy from iOS, Copy to Android and Copy to iOS](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/6.x-theme-overrides-copy-menu.png)


## Related topics

- [Accessibility](https://docs.flowx.ai/6.x/docs/platform-deep-dive/accessibility.md)
- [Reconcile supplier invoices against purchase orders](https://docs.flowx.ai/6.x/cookbooks/invoice-reconciliation.md)
- [Reference types in resources usage](https://docs.flowx.ai/6.x/docs/projects/reference-types.md)
- [Navigation areas](https://docs.flowx.ai/6.x/docs/building-blocks/process/navigation-areas.md)
- [Indicators](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/indicators.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.