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

# TextareaField Multi-line Input

> Reference for the TextareaField multi-line input component, covering input area and character count properties. Ideal for entering long-form text such as feedback.

## When to Use

* Use for scenarios that require entering large amounts of text, where the input area needs to be larger than a standard text input.

## Component Example

## Component Properties

| Attribute          | Description                                                                                                                            | Type                                                             | Default        |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------------- |
| `addonAfter`       | Content appended after the input.                                                                                                      | `string`                                                         | -              |
| `addonBefore`      | Content prepended before the multi-line input.                                                                                         | `string`                                                         | -              |
| `autoFocus`        | Whether to enable auto-focus.                                                                                                          | `boolean`                                                        | `false`        |
| `autoHeight`       | Whether to enable auto height for the multi-line input.                                                                                | `boolean`                                                        | `false`        |
| `behavior`         | Display state of the form component.                                                                                                   | [Behavior](/open/yida/components/interface#behavior)             | `'NORMAL'`     |
| `cutString`        | Whether to truncate the string when it exceeds maxLength.                                                                              | `boolean`                                                        | `false`        |
| `hasClear`         | Whether to enable the clear button on the multi-line text.                                                                             | `boolean`                                                        | `true`         |
| `hasLimitHint`     | Whether to display the character counter for the multi-line text.                                                                      | `boolean`                                                        | `false`        |
| `label`            | Title of the form component.                                                                                                           | `string`                                                         | -              |
| `labelAlign`       | Position of the form component title.                                                                                                  | `'left' \| 'top'`                                                | `'top'`        |
| `labelColOffset`   | Offset position of the title. The value is a grid value, where 1 represents 1/24.                                                      | `number`                                                         | `0`            |
| `labelColSpan`     | Width of the title. The value is a grid value, where 1 represents 1/24.                                                                | `number`                                                         | `4`            |
| `labelTextAlign`   | Alignment of the form component title.                                                                                                 | `'left' \| 'right'`                                              | `'right'`      |
| `labelTipsIcon`    | Entry icon for the tips of the form component title. Takes effect when labelTipsTypes is set to **text** or **render**.                | `string`                                                         | -              |
| `labelTipsRender`  | Custom render method for the tips of the form component title. Takes effect when labelTipsTypes is set to **render**.                  | `(props: IComponentProps) => ReactNode`                          | -              |
| `labelTipsText`    | Tips text for the form component title. Takes effect when labelTipsTypes is set to **text**.                                           | `string`                                                         | -              |
| `labelTipsTypes`   | Type setting for the tips of the form component title.                                                                                 | [LabelTipsTypes](/open/yida/components/interface#labeltipstypes) | `'none'`       |
| `maxLength`        | Character limit for the multi-line text.                                                                                               | `number`                                                         | -              |
| `onChange`         | Event triggered when the component value changes.                                                                                      | `({ value: string }) => void`                                    | -              |
| `placeholder`      | Placeholder text for the form component.                                                                                               | `string`                                                         | `Please enter` |
| `rows`             | Height of the multi-line text. Takes effect on PC only.                                                                                | `number`                                                         | `4`            |
| `size`             | Size of the form component.                                                                                                            | [Size](/open/yida/components/interface#size)                     | `'medium'`     |
| `state`            | State of the input.                                                                                                                    | `'error' \| 'loading' \| 'success' \| ''`                        | `''`           |
| `tips`             | Description of the form component, displayed below the control.                                                                        | `string`                                                         | -              |
| `trim`             | Whether to automatically trim leading and trailing whitespace.                                                                         | `boolean`                                                        | `false`        |
| `validation`       | Validation settings for the form component. For details, see the [form validation documentation](/open/yida/guide/concept/validation). | [Validation\[\]](/open/yida/components/interface#validation)     | `[]`           |
| `value`            | Default value of the current component.                                                                                                | `string`                                                         | -              |
| `wrapperColOffset` | Offset position of the form component. The value is a grid value, where 1 represents 1/24.                                             | `number`                                                         | `0`            |
| `wrapperColSpan`   | Width of the form component. The value is a grid value, where 1 represents 1/24.                                                       | `number`                                                         | `0`            |