# Textarea

Багаторядкове поле з опційним автоматичним ростом під вміст.


## Автоматичний ріст


Example (app/demos/textarea/TextareaAutoresize.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiTextarea from '~/components/ui/UiTextarea.vue'

const text = ref('Спробуйте додати кілька рядків — поле росте разом із текстом.')
</script>

<template>
  <div class="w-full max-w-md">
    <UiTextarea
      v-model="text"
      label="Опис"
      autoresize
      :max-rows="8"
      :max-length="280"
      show-count
      hint="Росте до восьми рядків, далі з'являється власна прокрутка."
    />
  </div>
</template>

```


## Розміри

`sm` — швидкий пошук чи коментар, `md` — типовий, `lg` — головне поле
сторінки. На мобільному текст 16px — iOS Safari не зумує сторінку при
фокусі, а висота росте з контентом (`min-h`), повертаючись до щільних
паддінгів на `md:`.


Example (app/demos/textarea/TextareaSizes.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiTextarea from '~/components/ui/UiTextarea.vue'

const quick = ref('')
const standard = ref('')
const main = ref('')
</script>

<!--
  Три щільності: sm — швидкий пошук/коментар, md — типовий, lg — головне
  поле сторінки. На мобільному текст 16px — без авто-зуму iOS Safari,
  висота росте з контентом (min-h), md: повертає щільні паддінги.
-->
<template>
  <div class="flex flex-col gap-4">
    <UiTextarea v-model="quick" size="sm" :rows="2" placeholder="Швидкий коментар (sm)…" />
    <UiTextarea v-model="standard" size="md" :rows="3" label="Опис (md)" placeholder="Типове поле…" />
    <UiTextarea v-model="main" size="lg" :rows="4" label="Текст листа (lg)" placeholder="Головне поле сторінки…" />
  </div>
</template>
```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiTextarea)

## Коли використовувати

Для тексту, довжина якого наперед невідома: опис, коментар, повідомлення.

`autoresize` доречний там, де поле — головний елемент екрана (поле вводу
чату). У щільній формі фіксована висота передбачуваніша.

Для полів із лімітом задайте `maxLength` і `showCount`: браузер не дасть
ввести зайве, а користувач бачитиме лічильник `поточна / максимальна`.

## Коли НЕ використовувати

Не вмикайте `autoresize` без стелі. Довгий текст виштовхне кнопку
«Надіслати» за межі екрана — типово `maxRows` дорівнює 12.

## Доступність

Висота перераховується у два кроки: спершу скидається в `auto`, і лише
потім читається `scrollHeight`. Без скидання поле росло б при видаленні
тексту так само, як при додаванні, бо `scrollHeight` ніколи не зменшується
сам.

Поле має рівно один активний опис: помилка має пріоритет над підказкою,
підказка — над лічильником. Видима помилка оголошується через `role="alert"`.

Атрибути, що не є props (`aria-label`, `spellcheck`, `data-*`), ідуть на
сам `<textarea>`; `class` і `style` — на обгортку разом із лейблом. Текст
на телефоні — 16px у пікселях: корінь документа 15px, і `text-base` (1rem)
давав 15px, на яких iOS зумує сторінку при фокусі.


## Event descriptions

- `update:modelValue`: Зміна значення.
- `focus`: Поле отримало фокус.
- `blur`: Поле втратило фокус.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/textarea.json)
