BAB 19: Form Dasar
Buat form yang dikontrol React dengan controlled component, hubungkan input ke state dan tangani perubahan nilai secara real-time.
Di bab sebelumnya kita berhasil merender daftar tugas dari sebuah array, data mengalir dari kode ke tampilan. Tapi selama ini data itu kita tulis langsung di dalam file, tidak pernah berasal dari pengguna. Aplikasi manajemen tugas yang sesungguhnya tentu butuh pengguna bisa menambahkan tugas sendiri. Artinya, kita butuh form.
Form di HTML sudah ada sejak awal web. Tapi cara React menangani form sedikit berbeda dari HTML biasa, dan memahami perbedaan ini adalah kunci agar form di React bekerja dengan benar.
HTML Form vs React Form
Di HTML standar, form element seperti <input> dan <textarea> menyimpan nilainya sendiri secara internal di dalam DOM. Kamu mengisinya, DOM menyimpannya. Ketika form di-submit, kamu baca nilai itu dari DOM.
React mengubah pendekatan ini sepenuhnya. Di React, nilai input tidak disimpan di DOM, melainkan di state komponen. Setiap kali pengguna mengetik sesuatu, state diperbarui. Nilai yang ditampilkan di input selalu mencerminkan isi state, bukan state internal DOM.
Pola ini disebut controlled component. Input yang "dikontrol" tidak punya pikiran sendiri, ia sepenuhnya dikendalikan oleh React.

Kenapa repot-repot? Karena dengan state sebagai satu sumber kebenaran, React tahu persis nilai apa yang ada di setiap input setiap saat, tanpa perlu membaca DOM. Ini membuat validasi, transformasi nilai, dan pengiriman data jauh lebih mudah dilakukan.
Membuat Input yang Dikontrol
Untuk aplikasi manajemen tugas kita, tambahkan form sederhana yang memungkinkan pengguna mengetik judul tugas baru. Kita buat komponen terpisah untuk form ini.
// src/components/FormTambahTugas.jsx
import { useState } from 'react'
function FormTambahTugas() {
const [judulTugas, setJudulTugas] = useState('')
function handleUbah(e) {
setJudulTugas(e.target.value)
}
return (
<div className="form-tambah">
<input
type="text"
value={judulTugas}
onChange={handleUbah}
placeholder="Tulis judul tugas baru..."
/>
<p>Kamu sedang mengetik: {judulTugas}</p>
</div>
)
}
export default FormTambahTugas
Ada dua hal penting di sini. Pertama, value={judulTugas} (ini yang menjadikan input controlled. Nilai yang ditampilkan di input selalu diambil dari state judulTugas, bukan dari DOM. Kedua, onChange={handleUbah}) setiap kali pengguna mengetik karakter, event ini terpicu dan memanggil setJudulTugas dengan nilai terbaru dari e.target.value.
Coba hapus onChange-nya dan kamu akan menemukan input yang tidak bisa diketik sama sekali. Itu karena React meng-override nilai DOM dengan state, dan state tidak pernah berubah tanpa onChange.
Input value tanpa onChange menghasilkan read-only input, tampak normal tapi tidak bisa diketik. React bahkan akan memunculkan warning di console: "You provided a value prop to a form field without an onChange handler." Jika kamu ingin nilai default tanpa mengontrolnya, gunakan defaultValue sebagai gantinya.
Memahami e.target.value
handleUbah menerima parameter e yang merupakan objek event dari browser. e.target merujuk pada elemen DOM yang memicu event, dalam hal ini <input> itu sendiri. Dan e.target.value adalah nilai teks yang sedang ada di dalam input saat event terjadi.
Kamu juga bisa menulis handler lebih ringkas menggunakan arrow function inline:
// src/components/FormTambahTugas.jsx
import { useState } from 'react'
function FormTambahTugas() {
const [judulTugas, setJudulTugas] = useState('')
return (
<div className="form-tambah">
<input
type="text"
value={judulTugas}
onChange={(e) => setJudulTugas(e.target.value)}
placeholder="Tulis judul tugas baru..."
/>
<p>Kamu sedang mengetik: {judulTugas}</p>
</div>
)
}
export default FormTambahTugas
Keduanya identik secara fungsional. Arrow function inline lebih ringkas dan cukup untuk handler sesederhana ini. Fungsi terpisah seperti handleUbah lebih cocok ketika logikanya lebih kompleks, misalnya perlu validasi atau transformasi sebelum di-set ke state.
Nilai Awal Input
Terkadang form perlu punya nilai default, misalnya form edit tugas yang mengisi input dengan judul tugas yang sudah ada. Cukup berikan nilai awal ke useState:
// src/components/FormEditTugas.jsx
import { useState } from 'react'
function FormEditTugas({ tugasAwal }) {
const [judulTugas, setJudulTugas] = useState(tugasAwal)
return (
<div className="form-edit">
<label htmlFor="judul-edit">Edit judul tugas:</label>
<input
id="judul-edit"
type="text"
value={judulTugas}
onChange={(e) => setJudulTugas(e.target.value)}
/>
<p>Judul baru: {judulTugas}</p>
</div>
)
}
export default FormEditTugas
State judulTugas diinisialisasi dengan tugasAwal yang dikirim via props. Hasilnya, input langsung menampilkan teks tersebut saat komponen pertama kali dirender, dan pengguna bisa langsung mengeditnya.
Perhatikan penggunaan htmlFor bukan for pada elemen <label>. Ini adalah konvensi JSX, atribut HTML yang namanya bertabrakan dengan keyword JavaScript diganti dengan padanannya. for di HTML menjadi htmlFor di JSX, sama seperti class menjadi className.
Membungkus dalam Elemen <form>
Input yang berdiri sendiri sudah cukup untuk banyak kasus, tapi biasanya input diletakkan di dalam elemen <form>. Ini memberi struktur semantik yang benar dan membuka pintu untuk penanganan submit yang akan kita bahas di bab berikutnya.
// src/components/FormTambahTugas.jsx
import { useState } from 'react'
function FormTambahTugas() {
const [judulTugas, setJudulTugas] = useState('')
return (
<form 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)}
placeholder="Contoh: Review pull request..."
/>
</div>
<p className="preview">Preview: {judulTugas || '(belum ada input)'}</p>
</form>
)
}
export default FormTambahTugas
Satu detail kecil: {judulTugas || '(belum ada input)'} menggunakan short-circuit || untuk menampilkan teks placeholder di preview ketika state masih kosong. Ini mencegah area preview terlihat kosong dan membingungkan pengguna.
Latihan
Kembangkan komponen form yang sudah kita buat:
-
Tambahkan state kedua
prioritasbertipe boolean (awalnyafalse). Pasangkan dengan checkbox input menggunakanchecked={prioritas}danonChange={(e) => setPrioritas(e.target.checked)}. Tampilkan teks "Prioritas tinggi" atau "Prioritas normal" berdasarkan nilai state tersebut. -
Buat komponen
FormCariTugasyang menerima propsonCari(sebuah fungsi). Setiap kali nilai input berubah, panggilonCari(nilaiInput). DiApp.jsx, gunakan statequeryPencarianuntuk menyimpan nilainya, lalu filterdaftarTugasmenggunakanqueryPencariansebelum di-render. -
Coba hapus atribut
valuedari input tapi pertahankanonChange. Amati apa yang terjadi, input jadi uncontrolled dan React tidak lagi menjadi satu-satunya sumber kebenaran. Kembalikanvaluesetelah selesai mengamati.
Penutup
Controlled component adalah fondasi dari semua form di React. Dengan menghubungkan value ke state dan onChange untuk memperbaruinya, React punya kendali penuh atas apa yang ada di dalam input setiap saat. Ini terasa sedikit lebih verbose dibanding HTML biasa, tapi keuntungannya langsung terasa ketika kamu butuh validasi atau transformasi nilai sebelum data dikirim.
Sampai sekarang, form kita hanya merespons perubahan input secara real-time. Tapi belum ada yang terjadi ketika pengguna menekan tombol kirim. Di bab berikutnya, kita akan menangani event onSubmit, cara React mencegat pengiriman form, memproses data, dan memutuskan apa yang harus dilakukan selanjutnya.