# Text area - TextArea

Multiline text input field.

![](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/qUScg2fRv7m089kfIxAY/4_files/image2025-5-14_14-12-18.png)

✅ **When to use:**

* The entered data consists of several sentences or a longer description (e.g. opinion, justification).

:x: **When not to use:**

* The data fits on one line. **Use**: [TextField](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/1-wprowadzanie-danych-inputs/pole-tekstowe-textfield).

## Component properties

| Eximee Designer property                                                              | Attribute name in the Source | Description                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Character counter** (section **Data quality**)                                      | characterCounter             | If set to "true", the component will display a counter showing how many characters have been entered. If the field also has a value set in **Maximum number of characters**, the component will also display information about the maximum possible number of characters to enter. Showing validation errors hides the counter. Availability of this feature depends on the license and may not be available in all deployments. |
| **Maximum number of characters**                                                      | maxLength                    | The maximum number of characters that can be entered in the field                                                                                                                                                                                                                                                                                                                                                                |
| **Message for exceeding the maximum number of characters** (section **Data quality**) | maxLengthWarning             | Message displayed after exceeding **the maximum number of characters**                                                                                                                                                                                                                                                                                                                                                           |
| **Maximum number of lines** (section **Data quality**)                                | maxLines                     | Maximum number of lines                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Minimum number of characters** (section **Data quality**)                           | minLength                    | Minimum number of characters                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Formatting**                                                                        | formatter                    | The name of the formatter used for the field. Availability of this feature depends on the license and may not be available in all deployments.                                                                                                                                                                                                                                                                                   |
| **Real-time formatting**                                                              | formatterRealTime            | Specifies whether formatting should occur after pressing a key on the keyboard, or only after leaving the field. Availability of this feature depends on the license and may not be available in all deployments.                                                                                                                                                                                                                |

> More information about component properties: [Common component properties](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow)

<figure><img src="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/db97CQ6rt4svF9FQ8Sqd/4_files/image2025-5-15_9-36-53.png" alt=""><figcaption><p><em><strong>Figure 1.</strong> Appearance of the component in a request with a specified maximum and minimum number of characters.</em></p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/XCXcEUFumrgw3OfFZL56/4_files/image2025-5-15_9-37-42.png" alt=""><figcaption><p><em><strong>Figure 2.</strong> Appearance of the inactive component in a request.</em></p></figcaption></figure>

{% hint style="info" %}
Demo request: demoTextComponents and demoText
{% endhint %}