# Textarea

```tsx
import { Textarea } from '@tangible/ui';
```

Interactive docs and examples: [Textarea in Storybook](https://storybook-tangible-ui.pages.dev/?path=/docs/forms-textarea--docs).

## Textarea props

| Prop | Type | Default | Description |
| - | - | - | - |
| `autoResize?` | `boolean` | `false` | Automatically grow height to fit content. Disables manual resize and sets `overflow: hidden`. **Warning:** If you apply an external `max-height` via CSS or `style`, content beyond that height will be clipped with no scrollbar. In that case, add `overflow-y: auto` to restore scrolling. |
| `className?` | `string` | | Class name applied to the textarea element. |
| `resize?` | `"both" \| "horizontal" \| "none" \| "vertical"` | `'vertical'` | Resize behaviour. Ignored when `autoResize` is true (resize is disabled to avoid conflict). Takes precedence over `style.resize` when both are provided. |
| `size?` | `"lg" \| "md" \| "sm"` | `'md'` | Control size. |

Also accepts the standard attributes of `TextareaHTMLAttributes` (`data-*`, `aria-*`, event handlers), passed to the element it renders.

## Examples

Stories: Basic, Controlled, Auto Resize, Sizes, Resize Options, Disabled, Read Only, Invalid, With Field ([interactive page](https://storybook-tangible-ui.pages.dev/?path=/docs/forms-textarea--docs)).

## Component API tokens

Read via fallback, never declared. Set one on an ancestor to restyle every instance under it.

- `--tui-input-`

---

Interactive version: https://storybook-tangible-ui.pages.dev/?path=/docs/forms-textarea--docs