Form

BAB 21: Textarea di React

Cara menggunakan elemen textarea di React sebagai controlled component, berbeda dari HTML biasa tapi konsisten dengan input.

Di penutup bab sebelumnya, kita menyebut bahwa form kita akan semakin kompleks, ada textarea untuk deskripsi panjang, select untuk kategori, hingga checkbox dan radio. Sekarang kita mulai dari textarea.

Pengguna aplikasi manajemen tugas kita mungkin ingin menambahkan catatan panjang ke setiap tugas, konteks mengapa tugas itu penting, tautan ke tiket, atau instruksi detail. Sebuah <input type="text"> tidak cukup untuk itu. Itulah alasan kita butuh textarea.

Perbedaan dari HTML Biasa

Di HTML murni, nilai awal sebuah textarea ditulis di antara tag pembuka dan penutup:

HTMLHTML
<!-- HTML biasa -->
<textarea>Isi konten di sini.</textarea>

React tidak menggunakan cara itu. Menaruh teks di antara tag <textarea> di JSX akan menghasilkan warning, dan nilainya tidak akan berperilaku seperti yang kita harapkan. React menggunakan atribut value: persis seperti <input>.

Ini bukan keputusan yang dibuat setengah-setengah. Konsistensi adalah alasannya: dengan semua elemen form menggunakan value, kita tidak perlu mengingat pola yang berbeda-beda untuk setiap jenis input.

Textarea sebagai Controlled Component

Pola yang kita gunakan untuk <input> di Bab 19 berlaku sama persis untuk <textarea>. State menyimpan nilai, onChange memperbarui state, dan React yang mengurus sinkronisasi ke DOM.

Mari tambahkan field deskripsi ke FormTambahTugas yang sudah kita buat:

React JSXJSX
// src/components/FormTambahTugas.jsx
import { useState } from 'react'

function FormTambahTugas({ onTambahTugas }) {
  const [judulTugas, setJudulTugas] = useState('')
  const [deskripsiTugas, setDeskripsiTugas] = useState('')
  const [pesanError, setPesanError] = useState('')

  function handleSubmit(e) {
    e.preventDefault()

    const trimmedJudul = judulTugas.trim()

    if (!trimmedJudul) {
      setPesanError('Judul tugas tidak boleh kosong.')
      return
    }

    if (trimmedJudul.length < 5) {
      setPesanError('Judul tugas minimal 5 karakter.')
      return
    }

    setPesanError('')
    onTambahTugas({
      judul: trimmedJudul,
      deskripsi: deskripsiTugas.trim(),
    })
    setJudulTugas('')
    setDeskripsiTugas('')
  }

  return (
    <form onSubmit={handleSubmit} className="form-tambah">
      <div className="form-group">
        <label htmlFor="judul-tugas">Judul tugas baru:</label>
        <input
          id="judul-tugas"
          type="text"
          value={judulTugas}
          onChange={(e) => {
            setJudulTugas(e.target.value)
            if (pesanError) setPesanError('')
          }}
          placeholder="Contoh: Review pull request..."
        />
        {pesanError && (
          <p className="error-msg">{pesanError}</p>
        )}
      </div>

      <div className="form-group">
        <label htmlFor="deskripsi-tugas">Deskripsi (opsional):</label>
        <textarea
          id="deskripsi-tugas"
          value={deskripsiTugas}
          onChange={(e) => setDeskripsiTugas(e.target.value)}
          placeholder="Tambahkan konteks, tautan, atau catatan..."
          rows={4}
        />
      </div>

      <button type="submit">Tambah Tugas</button>
    </form>
  )
}

export default FormTambahTugas

Ada beberapa hal yang perlu diperhatikan. rows={4} menentukan tinggi awal textarea dalam satuan baris, ini atribut HTML standar yang tetap bisa digunakan di React. Tanpa rows, textarea akan sangat pendek dan tidak nyaman diisi.

Kedua, tidak ada disabled di tombol submit seperti sebelumnya, karena deskripsi bersifat opsional. Pengguna bisa submit dengan deskripsi kosong, dan itu memang yang kita inginkan.

Memperbarui App.jsx

onTambahTugas sekarang menerima objek, bukan string. Kita perlu menyesuaikan App.jsx:

React JSXJSX
// src/App.jsx
import { useState } from 'react'
import FormTambahTugas from './components/FormTambahTugas'

const tugasAwal = [
  { id: 1, judul: 'Review pull request', deskripsi: 'Lihat PR #42 di repo backend', selesai: false },
  { id: 2, judul: 'Update dokumentasi API', deskripsi: '', selesai: true },
  { id: 3, judul: 'Fix bug login mobile', deskripsi: 'Terjadi di iOS 17, tidak di Android', selesai: false },
]

function App() {
  const [daftarTugas, setDaftarTugas] = useState(tugasAwal)

  function handleTambahTugas({ judul, deskripsi }) {
    const tugasBaru = {
      id: Date.now(),
      judul,
      deskripsi,
      selesai: false,
    }
    setDaftarTugas([...daftarTugas, tugasBaru])
  }

  return (
    <div className="app">
      <h1>Daftar Tugas</h1>
      <FormTambahTugas onTambahTugas={handleTambahTugas} />
      <ul>
        {daftarTugas.map((tugas) => (
          <li key={tugas.id}>
            <strong>{tugas.judul}</strong>
            {tugas.deskripsi && (
              <p className="deskripsi">{tugas.deskripsi}</p>
            )}
            {tugas.selesai ? ' (selesai)' : ''}
          </li>
        ))}
      </ul>
    </div>
  )
}

export default App

Perhatikan tugas.deskripsi && (...) di bagian render daftar, kita hanya menampilkan paragraf deskripsi kalau nilainya tidak kosong. Ini menghindari elemen <p> kosong yang muncul di semua tugas yang tidak punya deskripsi.

Props Berguna untuk Textarea

textarea punya beberapa props yang sering berguna dalam situasi nyata. Berikut yang paling sering dipakai:

PropsTipeKegunaan
rowsnumberTinggi awal textarea (dalam baris)
colsnumberLebar awal textarea (dalam karakter)
maxLengthnumberBatas maksimal jumlah karakter
minLengthnumberBatas minimal jumlah karakter
placeholderstringTeks petunjuk saat textarea kosong
readOnlybooleanTidak bisa diubah, tapi nilainya bisa diseleksi
disabledbooleanTidak bisa diubah dan tidak bisa diseleksi
requiredbooleanWajib diisi untuk submit form

Untuk aplikasi kita, maxLength berguna jika kita ingin membatasi panjang deskripsi. Mari tambahkan penghitung karakter yang umum ditemui di form modern:

React JSXJSX
// src/components/FormTambahTugas.jsx: bagian textarea saja
const MAKS_DESKRIPSI = 200

// di dalam return:
<div className="form-group">
  <label htmlFor="deskripsi-tugas">
    Deskripsi (opsional):
  </label>
  <textarea
    id="deskripsi-tugas"
    value={deskripsiTugas}
    onChange={(e) => setDeskripsiTugas(e.target.value)}
    placeholder="Tambahkan konteks, tautan, atau catatan..."
    rows={4}
    maxLength={MAKS_DESKRIPSI}
  />
  <span className="char-counter">
    {deskripsiTugas.length}/{MAKS_DESKRIPSI}
  </span>
</div>

maxLength bekerja di level DOM, browser tidak akan membiarkan pengguna mengetik lebih dari 200 karakter. Tapi kita tetap menampilkan penghitung secara visual agar pengguna tahu berapa sisa karakter yang tersedia sebelum mencapai batas.

Nilai MAKS_DESKRIPSI dideklarasikan sebagai konstanta di luar komponen, bukan di-hardcode langsung di JSX. Jika suatu saat batasnya berubah, kita cukup mengubah di satu tempat, tidak perlu mencari dua nilai 200 di kode.

Uncontrolled Textarea

Ada kasus di mana kita tidak butuh React untuk melacak nilai textarea secara real-time, misalnya form sederhana yang hanya dibaca saat submit. Untuk situasi itu, defaultValue lebih tepat daripada value:

React JSXJSX
// src/components/FormCatatanCepat.jsx
function FormCatatanCepat({ onSimpan }) {
  function handleSubmit(e) {
    e.preventDefault()
    const data = new FormData(e.target)
    const catatan = data.get('catatan-cepat')
    onSimpan(catatan)
    e.target.reset()
  }

  return (
    <form onSubmit={handleSubmit}>
      <textarea
        name="catatan-cepat"
        defaultValue="Tulis catatan kilat di sini..."
        rows={3}
      />
      <button type="submit">Simpan</button>
    </form>
  )
}

export default FormCatatanCepat

Di sini tidak ada state sama sekali. defaultValue mengisi nilai awal, dan saat submit kita ambil nilainya lewat FormData. e.target.reset() mengosongkan form setelah submit, fungsi bawaan DOM yang berguna untuk uncontrolled form.

Jangan campurkan value dan defaultValue di textarea yang sama. value menjadikan textarea controlled, defaultValue untuk uncontrolled. React akan memberikan peringatan jika kamu mencoba berpindah antara keduanya dalam satu lifecycle komponen.

Latihan

Kembangkan implementasi yang sudah kita buat:

  1. Tambahkan validasi panjang minimal untuk deskripsi: jika pengguna mengisi deskripsi tapi panjangnya kurang dari 10 karakter, tampilkan pesan error "Deskripsi terlalu pendek". Jika deskripsi dibiarkan kosong, tidak ada error.

  2. Buat komponen PreviewTugas yang menerima props judul dan deskripsi, lalu menampilkan preview real-time di sebelah form. Preview harus terus diperbarui setiap kali pengguna mengetik di input judul atau textarea deskripsi.

  3. Tambahkan tombol "Bersihkan" yang mereset kedua field (judul dan deskripsi) ke string kosong tanpa mengosongkan state error. Petunjuk: kamu butuh memanggil dua fungsi setState sekaligus.

Penutup

textarea di React bekerja dengan pola yang sama dengan input: value untuk nilai, onChange untuk memperbarui state. Perbedaannya hanya di cara HTML aslinya bekerja, yang React sengaja normalkan agar developer tidak perlu mengingat dua cara yang berbeda.

Form FormTambahTugas kita sekarang punya judul dan deskripsi. Tapi masih ada jenis input lain yang sering muncul di form: dropdown <select> yang memungkinkan pengguna memilih dari daftar opsi tetap. Itulah yang akan kita tambahkan ke form ini selanjutnya.

Referensi

  1. 1 textarea: React DOM Reference
  2. 2 Sharing State Between Components: React Documentation
  3. 3 textarea: The Textarea element: MDN Web Docs