Textarea
Textarea menerima teks yang lebih dari satu baris, misalnya catatan atau deskripsi, dan tingginya ikut bertambah sesuai isi.
Kapan dipakai
Section titled “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.”
Paling banyak 500 karakter.
Paling banyak 500 karakter.
Anatomi
Section titled “Anatomi”- 1Label
- 2Kolom yang tumbuh mengikuti teks
- 3Pegangan 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
Section titled “Varian”Hanya ada satu gaya.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/textarea.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/textarea.jsonAksesibilitas
Section titled “Aksesibilitas”- Beri label yang terlihat di dalam Field.
- Hubungkan hint dan error ke textarea lewat
aria-describedby. - Perilaku keyboard
textareabawaan tetap: Enter menambah baris, Tab berpindah ke kontrol berikutnya.
