Tips Praktis Menulis Validasi Form di Rails untuk Pemula

Validasi form di Ruby on Rails paling aman ditulis di model, bukan di controller atau view. Pesan error dari model otomatis terhubung ke atribut sehingga form bisa menampilkannya tanpa logika tambahan. Untuk pemula, mulai dari aturan sederhana seperti wajib isi dan format email, lalu rawat pesannya agar mudah dipahami pengguna.

Mulai dari validasi di model

Active Record menyediakan banyak helper validasi siap pakai. Kamu cukup menambahkannya di file model dan Rails akan memeriksa data setiap kali save atau valid? dipanggil. Contohnya, model User dengan aturan wajib isi dan format email:

class User < ApplicationRecord
  validates :name, presence: true, length: { maximum: 50 }
  validates :email, presence: true, uniqueness: true, format: { with: URI::MailTo::EMAIL_REGEXP }
end

Dengan begini, controller tinggal memanggil @user.save. Kalau validasi gagal, Rails mengembalikan false dan error tersimpan di @user.errors. Kamu tidak perlu menulis pengecekan manual satu per satu.

Pilih helper validasi yang sesuai kebutuhan

Jangan langsung memakai semua helper yang tersedia. Pilih yang relevan dengan aturan bisnis aplikasimu. Beberapa yang paling sering dipakai:

• presence untuk memastikan atribut tidak kosong.
• length untuk membatasi jumlah karakter, misalnya nama maksimal 50 karakter.
• format untuk memeriksa pola tertentu seperti email atau nomor telepon.
• uniqueness untuk mencegah duplikasi data di database, tapi tetap siapkan index unik di level database.
• numericality untuk memastikan nilai berupa angka dan sesuai rentang.

Hindari menumpuk banyak aturan pada satu atribut tanpa alasan jelas. Semakin banyak aturan, semakin rumit pesan error yang harus kamu tangani.

Tampilkan pesan error di form

Rails menyediakan objek errors yang bisa diakses di view. Cara paling sederhana adalah menampilkan daftar error di atas form, lalu pesan spesifik di bawah setiap input. Contoh di form partial:

<% if @user.errors.any? %>
  <div class="errors">
    <h2><%= pluralize(@user.errors.count, "error") %> menghalangi penyimpanan:</h2>
    <ul>
      <% @user.errors.full_messages.each do |msg| %>
        <li><%= msg %></li>
      <% end %>
    </ul>
  </div>
<% end %>

Kalau ingin pesan muncul tepat di bawah input, gunakan helper seperti @user.errors.full_messages_for(:email). Untuk validasi sisi klien yang lebih responsif, kamu bisa menambahkan JavaScript. Ada panduan praktis tentang cara menampilkan error validasi di bawah input dengan JavaScript yang bisa kamu adaptasi.

Tulis pesan error yang membantu

Pesan bawaan Rails sering kali cukup jelas, tetapi bisa terdengar kaku. Kamu bisa menggantinya dengan opsi message pada helper validasi atau melalui file locale. Contoh:

validates :email, presence: { message: "jangan kosong, ya" }

Namun, jangan berlebihan. Pesan yang terlalu santai justru membingungkan di konteks formal. Fokus pada tiga hal: apa yang salah, di atribut mana, dan apa yang harus dilakukan pengguna. Misalnya, “Email sudah terdaftar, coba gunakan email lain” lebih membantu daripada “Email tidak valid”.

Uji validasi dengan test

Validasi yang tidak diuji mudah rusak saat model berubah. Tulis test model untuk memastikan aturan bekerja sesuai harapan. Di Rails, kamu bisa memakai Minitest atau RSpec. Contoh dengan Minitest:

test "tidak valid tanpa email" do
  user = User.new(name: "Budi")
  assert_not user.valid?
  assert_includes user.errors[:email], "can't be blank"
end

Dengan test, kamu bisa mengubah pesan atau menambah aturan tanpa takut merusak validasi lain. Ini juga memaksa kamu memikirkan kasus tepi, seperti email dengan spasi di awal atau karakter khusus.

Hindari jebakan umum

Beberapa kesalahan sering dilakukan pemula saat menulis validasi. Pertama, menaruh logika validasi di controller. Itu membuat aturan tersebar dan sulit dipakai ulang. Kedua, lupa menambahkan index unik di database saat memakai validasi uniqueness. Tanpa index, dua request bersamaan bisa menyimpan data duplikat. Ketiga, menampilkan semua error sekaligus di satu tempat tanpa menandai input mana yang bermasalah. Pengguna jadi harus menebak.

Kalau aplikasimu mulai berkembang, pertimbangkan memisahkan validasi ke form object atau service object. Tapi untuk pemula, mulailah dari model dulu. Setelah nyaman, kamu bisa membaca tips cepat belajar Ruby on Rails untuk pemula agar pemahamanmu tentang struktur Rails makin kuat.

Ringkasan

Validasi form di Rails sebaiknya ditulis di model dengan helper yang sesuai kebutuhan. Tampilkan pesan error di view, tulis pesan yang jelas, dan uji dengan test. Hindari menaruh logika validasi di controller dan pastikan database punya index unik untuk aturan uniqueness.

Pertanyaan yang Sering Diajukan

Apakah validasi di model bisa diganti dengan validasi JavaScript saja?

Tidak. Validasi JavaScript hanya berjalan di browser dan bisa dilewati. Validasi di model tetap diperlukan sebagai lapisan terakhir sebelum data masuk ke database.

Bagaimana cara menampilkan pesan error hanya untuk satu atribut?

Gunakan @user.errors.full_messages_for(:email) di view. Metode ini mengembalikan array pesan error khusus untuk atribut email.

Apakah perlu menambahkan index unik saat memakai validasi uniqueness?

Ya. Validasi uniqueness di Rails tidak menjamin keunikan di level database. Tanpa index unik, dua proses yang berjalan bersamaan bisa menyimpan data duplikat.