# TextArea

- Page: https://jiguang132.com/resources/ant-design-mobile/docs/text-area
- Resource: Ant Design Mobile (https://jiguang132.com/resources/ant-design-mobile.md)
- All guides: https://jiguang132.com/resources/ant-design-mobile/docs.md

Entering content through the keyboard is the most basic form field wrapper.

## Install

```bash
npm install antd-mobile@5.43.0
```

antd-mobile is for mobile web, not React Native or Mini Programs. React 19 projects must register `createRoot` with `unstableSetRender` at the entry, or imperative APIs such as Toast and Dialog cannot render. Switch dark mode with `<html data-prefers-color-scheme="dark">`.

Examples come from the official Ant Design Mobile repository (MIT) at the commit published as npm 5.43.0. Presentation helpers such as `DemoBlock` are JGuang rewrites, not antd-mobile APIs.

Entering content through the keyboard is the most basic form field wrapper.

## When to Use

Long text input that requires wrapping.

## Demos

## TextArea

### Props

| Name | Description | Type | Default |
| --- | --- | --- | --- |
| autoSize | Adaptive content height | `boolean \| { minRows?: number, maxRows?: number }` | `false` |
| defaultValue | Input value by default | `string` | - |
| id | `id` of `textarea` element, often used in conjunction with `label` | `string` | - |
| maxLength | Maximum number of characters | `number` | - |
| onChange | Triggered when the TextArea content changed | `(value: string) => void` | - |
| placeholder | Hint text | `string` | - |
| rows | Number of rows | `number` | `2` |
| showCount | Display the number of words, supports custom render | `boolean \| ((length: number, maxLength?: number) => ReactNode)` | `false` |
| value | Input value | `string` | - |

In addition, the following native attributes are supported: `autoComplete` `autoFocus` `disabled` `readOnly` `onFocus` `onBlur` `onCompositionStart` `onCompositionEnd` `onClick`

### CSS Variables

| Name | Description | Default |
| --- | --- | --- |
| --color | font color. | `var(--adm-color-text)` |
| --count-text-align | The alignment of count text. | `right` |
| --disabled-color | font color in disabled status. | `var(--adm-color-weak)` |
| --font-size | font size. | `17px` |
| --placeholder-color | `placeholder` font color. | `var(--adm-color-light)` |
| --text-align | The alignment of text. | `left` |

### Ref

| Name | Description | Type |
| --- | --- | --- |
| blur | Let the input box lose focus | `() => void` |
| clear | Clear the input content | `() => void` |
| focus | Let the input box get focus | `() => void` |
| nativeElement | Native text-area element | `HTMLTextAreaElement` \| `null` |

---

Index of all JGuang resources: https://jiguang132.com/llms.txt