# Textarea

> Kolom teks beberapa baris.

Textarea menerima teks yang lebih dari satu baris, misalnya catatan atau deskripsi, dan tingginya ikut bertambah sesuai isi.

## Kapan dipakai

- Pakai untuk catatan, deskripsi, dan pesan.
- Pakai Input untuk satu baris, misalnya nama atau judul.
- Taruh di dalam Field, dengan hint yang menyebut batasnya, misalnya "Paling banyak 500 karakter."

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/textarea/_

## Anatomi

1. Label
2. Kolom yang tumbuh mengikuti teks
3. Pegangan ubah ukuran

Kotak dengan `radius-md` dan border `input`, tinggi minimal `min-h-16`, yang memanjang sesuai isi (`field-sizing-content`). Saat fokus muncul `ring`; nilai yang tidak valid membuat bordernya `destructive`.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `controller` / `initialValue` | teks | tidak ada | Isi teks. |
| `maxLength` | `maxlength` | `maxLength` | angka | tidak ada | Panjang maksimal. Sebutkan juga di hint. |
| `rows` | `rows` | `minHeight` | angka | ikut isi | Tinggi awal. |
| `aria-invalid` | `aria-invalid` | `forceErrorText` di `ShadTextareaFormField` | boolean | `false` | Menandai nilai yang ditolak. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mencegah pengetikan. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Textarea } from "@/components/ui/textarea"

export default function TextareaDemo() {
  const id = useId()
  return (
    <Field className="w-full max-w-sm">
      <FieldLabel htmlFor={`${id}-notes`}>Catatan untuk tim</FieldLabel>
      <Textarea id={`${id}-notes`} maxLength={500} aria-describedby={`${id}-notes-hint`} />
      <FieldDescription id={`${id}-notes-hint`}>Paling banyak 500 karakter.</FieldDescription>
    </Field>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Textarea } from "@/components/ui/textarea"

const id = useId()
</script>

<template>
  <Field class="w-full max-w-sm">
    <FieldLabel :for="`${id}-notes`">Catatan untuk tim</FieldLabel>
    <Textarea :id="`${id}-notes`" :maxlength="500" :aria-describedby="`${id}-notes-hint`" />
    <FieldDescription :id="`${id}-notes-hint`">Paling banyak 500 karakter.</FieldDescription>
  </Field>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TextareaDemo extends StatelessWidget {
  const TextareaDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    // ShadTextareaFormField does not pass maxLength on, so the label and hint sit around a ShadTextarea.
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        spacing: 8,
        children: [
          Text('Catatan untuk tim', style: theme.textTheme.small),
          const ShadTextarea(maxLength: 500),
          Text('Paling banyak 500 karakter.', style: theme.textTheme.muted),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/textarea.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/textarea.json
```

## Aksesibilitas

- Beri label yang terlihat di dalam Field.
- Hubungkan hint dan error ke textarea lewat `aria-describedby`.
- Perilaku keyboard `textarea` bawaan tetap: Enter menambah baris, Tab berpindah ke kontrol berikutnya.
