Form

BAB 20: Form Submit

Tangani pengiriman form dengan onSubmit, cegah reload halaman dengan preventDefault, dan kirim data ke server atau proses lokal.

Di bab sebelumnya, kita sudah membangun FormTambahTugas yang benar-benar merespons setiap ketikan, state judulTugas selalu up-to-date dengan apa yang ada di input. Tapi form itu belum punya tombol kirim. Pengguna mengetik, dan tidak ada yang terjadi selanjutnya.

Itulah yang akan kita selesaikan sekarang: menangani momen ketika pengguna menekan tombol submit dan data perlu diproses.

Event onSubmit dan preventDefault

HTML punya perilaku default yang sudah ada sejak dulu: ketika sebuah <form> di-submit, browser akan me-reload halaman. Di era web statis ini masuk akal, form dikirim ke server, server memproses, dan halaman baru dimuat. Tapi di aplikasi React yang berjalan di sisi klien, reload halaman berarti semua state hilang dan aplikasi dimulai dari nol.

Solusinya ada di satu baris kode: e.preventDefault().

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

function FormTambahTugas() {
  const [judulTugas, setJudulTugas] = useState('')

  function handleSubmit(e) {
    e.preventDefault()
    console.log('Tugas dikirim:', judulTugas)
  }

  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)}
          placeholder="Contoh: Review pull request..."
        />
      </div>
      <button type="submit">Tambah Tugas</button>
    </form>
  )
}

export default FormTambahTugas

onSubmit dipasang di elemen <form>, bukan di tombol. Ini penting, karena form bisa di-submit dengan berbagai cara: klik tombol, menekan Enter di dalam input, atau bahkan secara programatik. Memasang handler di <form> memastikan semua cara tersebut tertangkap.

e.preventDefault() dipanggil pertama kali di dalam handleSubmit sebelum logika apapun. Ini menghentikan perilaku default browser, memberi React kesempatan untuk mengambil alih sepenuhnya.

Memproses Data dan Mereset Form

Setelah preventDefault, kita bebas melakukan apa saja dengan data yang ada di state. Untuk aplikasi manajemen tugas, langkah berikutnya adalah menambahkan tugas baru ke daftar dan mengosongkan input agar siap untuk entri berikutnya.

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

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

  function handleSubmit(e) {
    e.preventDefault()

    const trimmed = judulTugas.trim()
    if (!trimmed) return

    onTambahTugas(trimmed)
    setJudulTugas('')
  }

  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)}
          placeholder="Contoh: Review pull request..."
        />
      </div>
      <button type="submit" disabled={!judulTugas.trim()}>
        Tambah Tugas
      </button>
    </form>
  )
}

export default FormTambahTugas

Ada beberapa hal baru di sini. Pertama, validasi ringan dengan .trim(), kita cegah tugas dengan judul kosong atau hanya spasi lolos masuk ke daftar. if (!trimmed) return menghentikan eksekusi lebih lanjut tanpa pesan error yang dramatis.

Kedua, onTambahTugas(trimmed), komponen ini tidak tahu apa-apa tentang daftar tugas yang ada. Ia hanya bertugas mengumpulkan input dari pengguna dan menyerahkannya ke luar melalui props. Ini prinsip single responsibility yang membuat komponen mudah diuji dan dipakai ulang.

Ketiga, setJudulTugas('') di akhir, input direset ke string kosong setelah submit berhasil. Karena input adalah controlled component, mengubah state berarti langsung mengubah tampilan input.

disabled={!judulTugas.trim()} membuat tombol tidak bisa diklik selama input kosong. Ini UX kecil yang mencegah submit accidental dan sekaligus memberi sinyal visual ke pengguna bahwa input diperlukan.

Menyambungkan ke Komponen Induk

Komponen FormTambahTugas kini menerima onTambahTugas sebagai props. Di App.jsx, kita perlu menyediakan fungsi itu dan menyambungkannya ke state daftar tugas.

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

const tugasAwal = [
  { id: 1, judul: 'Review pull request', selesai: false },
  { id: 2, judul: 'Update dokumentasi API', selesai: true },
  { id: 3, judul: 'Fix bug login mobile', selesai: false },
]

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

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

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

export default App

handleTambahTugas di App.jsx menerima string judul, membuat objek tugas baru dengan id unik dari Date.now(), lalu menggunakan spread operator untuk menambahkannya ke akhir array. setDaftarTugas([...daftarTugas, tugasBaru]), pola ini sudah kita kenal dari bab-bab sebelumnya: selalu buat array baru, jangan mutasi state langsung.

Sekarang, setiap kali pengguna mengisi input dan menekan "Tambah Tugas", tugas baru langsung muncul di daftar dan input kembali kosong.

Alur Lengkap Submit

Untuk melihat gambaran utuh dari apa yang terjadi saat pengguna menekan tombol:

Flowchart alur form submit React dari pengguna tekan submit hingga React render ulang dengan percabangan validasi input kosong

Gambar 1: Alur form submit React

Validasi Sebelum Submit

Aplikasi nyata biasanya butuh validasi yang lebih dari sekadar "tidak boleh kosong". Misalnya, judul tugas tidak boleh terlalu pendek. Kita bisa tambahkan state error untuk menampilkan pesan kepada pengguna:

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

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

  function handleSubmit(e) {
    e.preventDefault()

    const trimmed = judulTugas.trim()

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

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

    setPesanError('')
    onTambahTugas(trimmed)
    setJudulTugas('')
  }

  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>
      <button type="submit">Tambah Tugas</button>
    </form>
  )
}

export default FormTambahTugas

Ada satu detail di onChange yang patut diperhatikan: if (pesanError) setPesanError(''). Ini membersihkan pesan error segera saat pengguna mulai mengetik lagi, memberi tahu pengguna bahwa input mereka sedang diproses, bukan didiamkan.

Validasi di sisi klien seperti ini mudah dibypass, pengguna bisa mengirim data langsung via fetch atau curl tanpa melewati form. Validasi di klien hanya untuk pengalaman pengguna yang lebih baik. Validasi yang sesungguhnya tetap harus dilakukan di sisi server.

Latihan

Kembangkan implementasi yang sudah kita buat:

  1. Tambahkan field input kedua kategori (dropdown <select>) dengan pilihan: "Pekerjaan", "Pribadi", "Belajar". Sertakan nilai kategori dalam objek tugas yang dikirim ke onTambahTugas. Tampilkan kategori di sebelah judul tugas di daftar.

  2. Buat state riwayatSubmit di App.jsx yang menyimpan array timestamp setiap kali tugas berhasil ditambahkan. Tampilkan teks "Tugas terakhir ditambahkan: [waktu]" di bawah form.

  3. Modifikasi handleTambahTugas agar menolak judul yang sudah ada di daftarTugas (perbandingan case-insensitive). Kirim pesan error yang sesuai ke FormTambahTugas melalui props tambahan errorEksternal.

Penutup

Submit form adalah titik di mana interaksi pengguna menghasilkan sesuatu yang nyata. Dengan onSubmit dan preventDefault, kita mencegat momen itu dan mengambil kendali penuh, validasi data, memperbarui state, mengosongkan form, semua terjadi di bawah kendali React tanpa reload halaman.

Pola yang kita bangun (form mengumpulkan data, induk mengelola state) adalah fondasi yang akan terus kita pakai. Di bab-bab berikutnya, form kita akan semakin kompleks: ada textarea untuk deskripsi panjang, select untuk kategori, hingga checkbox dan radio untuk pilihan yang lebih kaya.

Referensi

  1. 1 form: React DOM Reference
  2. 2 Event.preventDefault(): MDN Web Docs
  3. 3 Sharing State Between Components: React Documentation