Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Textarea

Textarea

Kolom untuk beberapa kalimat: kotak .control yang sama, lebih tinggi, dengan penghitung karakter opsional. Sebutkan batasnya sebelum orang mencapainya.

Penggunaan

Pakai saat

  • Orang menulis lebih dari satu baris: catatan untuk petugas, alasan permohonan, laporan kesalahan data.
  • Kolom punya batas karakter dan orang perlu melihat sisa ruangnya (.counter).

Pakai yang lain saat

  • Satu baris pendek (nama, judul, email): pakai Text field.
  • Menulis pesan chat yang terkirim saat Enter: pakai Composer.
  • Konten panjang berformat (artikel, panduan layanan): pakai Prose. Pakai editor sungguhan; textarea hanya teks biasa.
  • Menyunting nilai pendek di tempat di dalam daftar atau tabel: pakai Inline edit.
  • Beberapa item pendek seperti topik atau email: pakai Tag input.

Letaknya. Di formulir, biasanya terakhir sebelum tombol, selebar kolom formulir. Di dialog atau modal untuk alur seperti "laporkan kesalahan".

Contoh

Dengan penghitungPenghitung berada di baris label, jadi tidak pernah menggeser teks bantuan. Dengan maxlength browser menghentikan input di batasnya, jadi penghitung tidak butuh status melebihi batas.
Petugas membaca catatan ini sebelum memproses permohonan.
<div class="field">
  <label class="field__label" for="note">Catatan untuk petugas <span class="counter" id="note-count">0 / 280</span></label>
  <div class="control control--area">
    <textarea id="note" maxlength="280" aria-describedby="note-help note-count"></textarea>
  </div>
  <span class="field__help" id="note-help">Petugas membaca catatan ini sebelum memproses permohonan.</span>
</div>
<!-- Update #note-count on input in your own code. -->
Alasan wajib dengan galatLaporan butuh alasan; teks bantuan menjelaskan detail seperti apa yang membantu.
Jelaskan kesalahannya, misalnya bagian mana yang keliru dan seharusnya apa.
<div class="field" style="max-width: 520px;">
  <label class="field__label" for="ta-why">Apa yang salah pada data ini?</label>
  <div class="control control--area is-invalid"><textarea id="ta-why" rows="4" aria-invalid="true" aria-describedby="ta-why-help"></textarea></div>
  <span class="field__help field__help--error" id="ta-why-help"><span class="ic" aria-hidden="true">error</span>Jelaskan kesalahannya, misalnya bagian mana yang keliru dan seharusnya apa.</span>
</div>

Anatomi

BagianFungsinya
.field / .field__label / .field__helpWajib. Pembungkus yang sama dengan text field.
.control.control--areaWajib. Kotak tumbuh sesuai tinggi isinya, padding 12 kali 14.
textareaWajib. Tinggi minimal 88 px (sekitar 3 baris), tinggi baris 22 px, tidak bisa diubah ukurannya dengan menyeret. Setel rows untuk awal yang lebih tinggi.
.counterOpsional. "120 / 280" tabular di dalam span label, rata kanan oleh label.

Status

StatusCaranya
focus / hoverSeperti text field: tepi aksen dan halo saat :focus-within.
.is-invalid + aria-invalidTepi dan halo danger; pesan di .field__help--error.
.is-disabled + disabledLatar berisi dan teks redup.

Gerak dan mikrointeraksi

  • Garis tepi dan halo bertransisi dalam --d-fast (160 ms) dengan --ease-standard, seperti setiap .control.
  • Penghitung berganti angka di tempat; tidak dianimasikan.
  • Reduced motion: transisi menjadi 120 ms linear.

Aksesibilitas

  • <label for> menamainya; teks bantuan dan penghitung sama-sama ada di aria-describedby agar batasnya diumumkan.
  • Utamakan maxlength (browser menghentikan input) dan sebutkan batasnya di awal; jika Anda mengizinkan melebihi batas dan memblokir saat dikirim, tandai aria-invalid dan sebutkan berapa karakter yang harus dihapus.
  • Enter membuat baris baru. Jangan pernah mengirim textarea saat Enter; itu pola composer.
  • Teks tampil 16 px di layar sentuh, agar iOS tidak memperbesar saat fokus.

Lakukan dan hindari

Lakukan

  • Mulai dengan tinggi jawaban yang diharapkan (rows="4" untuk satu paragraf).
  • Tampilkan penghitung hanya jika ada batas yang perlu diketahui.

Hindari

  • Mengizinkan pegangan seret bawaan atau menyetel tinggi tetap yang sangat kecil; ukuran kotak ditentukan oleh rows.
  • Memakai textarea untuk satu nilai yang diharapkan muat dalam satu baris.

Perilaku dan kode

HTML biasa. Tidak ada. Perbarui teks .counter saat input di kode Anda sendiri.