# TextArea: API

## Пропсы корня

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `placeholder` | `string` | — | Нет | Текст-заполнитель, который показывается, когда текстовая область пустая. |
| `value` | `string \| number` | — | Нет | Текущее значение текстовой области. Может быть строкой или числом. |
| `size` | `TextAreaSize` | `'md'` | Нет | Визуальный размер текстовой области. Управляет предустановками отступов, размера шрифта и высоты. |
| `error` | `boolean` | — | Нет | Показывает текстовую область в состоянии ошибки. |
| `fullWidth` | `boolean` | — | Нет | Растягивает текстовую область на всю ширину контейнера. |
| `ref` | `Ref<HTMLTextAreaElement>` | — | Нет | Ref, передаваемый на нативный элемент `<textarea>`. Полезен для управления фокусом, измерений или интеграций. |

Также принимает все атрибуты `<textarea>`.

## Дочерние части

- Нет. `TextArea` — единственный экспортируемый элемент управления.

## Типы

- `TextAreaProps`
- `TextAreaSize`

## Модель состояния

- Контролируемое и неконтролируемое поведение следуют правилам нативного `<textarea>`.
- Состояние ошибки визуальное и не заменяет семантику валидации.