Vue.js Diterbitkan: • Diperbarui: • 4 menit baca • 3 views

Membangun Composable Validasi Form & Debounce Input di Vue 3 Tanpa Library Berat

Juan Mths
Juan Mths
Chief Technology Officer & Administrator
Ilustrasi Membangun Composable Validasi Form & Debounce Input di Vue 3 Tanpa Library Berat

Ketika aplikasi Vue 3 hanya memiliki satu formulir login, menulis variabel errorEmail dan fungsi cek manual di dalam komponen terasa cepat. Begitu proyek tumbuh menjadi lima atau sepuluh formulir—pendaftaran, profil, kontak, tambah produk, hingga editor artikel—menduplikasi logika status isSubmitting, penanda touched, dan pemetaan galat validasi 422 Unprocessable Entity dari backend di setiap komponen segera menjadi sumber bug berulang.

Melengkapi pembahasan dasar Composition API Vue 3 dan pengelolaan state di Pinia Setup Store, artikel ini membangun dua composable murni tanpa dependensi eksternal: useFormValidation dan useDebouncedRef.

1. Merancang Composable useFormValidation

Pengalaman pengguna yang baik memiliki dua aturan penting: jangan tampilkan pesan error merah sebelum pengguna selesai mengetik atau berpindah kolom (on blur), dan bersihkan pesan error server secara otomatis begitu pengguna mulai menyunting ulang kolom tersebut.

// src/composables/useFormValidation.js
import { reactive, ref, computed } from 'vue';

export function useFormValidation(initialValues, rules) {
  const values = reactive({ ...initialValues });
  const errors = reactive({});
  const touched = reactive({});
  const isSubmitting = ref(false);

  function validateField(field) {
    const fieldRules = rules[field] ?? [];
    for (const rule of fieldRules) {
      const result = rule(values[field], values);
      if (result !== true) {
        errors[field] = result;
        return false;
      }
    }
    delete errors[field];
    return true;
  }

  function handleBlur(field) {
    touched[field] = true;
    validateField(field);
  }

  function clearFieldError(field) {
    if (errors[field]) {
      validateField(field);
    }
  }

  function validateAll() {
    let valid = true;
    for (const field of Object.keys(rules)) {
      touched[field] = true;
      if (!validateField(field)) {
        valid = false;
      }
    }
    return valid;
  }

  function setServerErrors(serverErrors = {}) {
    for (const [field, messages] of Object.entries(serverErrors)) {
      touched[field] = true;
      errors[field] = Array.isArray(messages) ? messages[0] : String(messages);
    }
  }

  function resetForm() {
    Object.assign(values, initialValues);
    for (const key of Object.keys(errors)) delete errors[key];
    for (const key of Object.keys(touched)) delete touched[key];
  }

  const hasErrors = computed(() => Object.keys(errors).length > 0);

  return {
    values,
    errors,
    touched,
    isSubmitting,
    hasErrors,
    handleBlur,
    clearFieldError,
    validateAll,
    setServerErrors,
    resetForm,
  };
}
Diagram siklus composable useFormValidation di Vue 3 dari validasi blur hingga pemetaan HTTP 422 dari server
Alur kerja useFormValidation(): memvalidasi saat blur, mencegah klik ganda lewat isSubmitting, dan otomatis memetakan respons validasi 422 ke kolom terkait.

2. Menambahkan Composable useDebouncedRef untuk Cek Ketersediaan

Sering kali formulir membutuhkan pengecekan asinkron ke server—misalnya memeriksa apakah slug artikel atau username sudah terpakai saat pengguna mengetik. Memakai watch dengan pembersihan onWatcherCleanup mencegah permintaan API tertembak pada setiap ketukan tombol serta membatalkan timer lama saat komponen di-unmount:

// src/composables/useDebouncedRef.js
import { ref, watch, onUnmounted } from 'vue';

export function useDebouncedRef(sourceGetter, delayMs = 400) {
  const debounced = ref(sourceGetter());
  let timerId = null;

  watch(sourceGetter, (newVal) => {
    clearTimeout(timerId);
    timerId = setTimeout(() => {
      debounced.value = newVal;
    }, delayMs);
  });

  onUnmounted(() => clearTimeout(timerId));

  return debounced;
}

3. Penerapan pada Komponen <script setup>

Sekarang komponen formulir terlihat deklaratif dan fokus pada markup UI serta aksesibilitas (aria-invalid dan aria-describedby):

<script setup>
import { useFormValidation } from '@/composables/useFormValidation';

const required = (msg) => (v) => (String(v ?? '').trim().length > 0 ? true : msg);
const minLen = (n, msg) => (v) => (String(v ?? '').trim().length >= n ? true : msg);
const validEmail = (v) => (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v) ? true : 'Format email tidak valid.');

const {
  values,
  errors,
  isSubmitting,
  handleBlur,
  clearFieldError,
  validateAll,
  setServerErrors,
  resetForm,
} = useFormValidation(
  { name: '', email: '', message: '' },
  {
    name: [required('Nama wajib diisi.'), minLen(3, 'Nama minimal 3 karakter.')],
    email: [required('Email wajib diisi.'), validEmail],
    message: [required('Pesan wajib diisi.'), minLen(15, 'Pesan minimal 15 karakter.')],
  }
);

async function submitContact() {
  if (!validateAll() || isSubmitting.value) return;

  isSubmitting.value = true;
  try {
    const res = await fetch('/api/contact', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
      body: JSON.stringify(values),
    });

    if (res.status === 422) {
      const payload = await res.json();
      setServerErrors(payload.errors);
      return;
    }

    if (!res.ok) throw new Error('Gagal mengirim pesan.');
    resetForm();
  } finally {
    isSubmitting.value = false;
  }
}
</script>

Kapan Cukup Memakai Composable Sendiri vs VeeValidate + Zod?

Kebutuhan Proyek Composable Sendiri (~70 Baris) VeeValidate + Zod / Valibot
Form login, kontak, komentar, CRUD standar Ideal; nol dependensi dan penuh kendali atas perilaku error server. Bisa dipakai, tetapi menambah bobot JavaScript.
Form multi-langkah & array field dinamis bersarang Mulai repot melacak indeks array dan dirty state per item. Sangat matang berkat dukungan useFieldArray dan validasi skema lintas-field.

Dengan membangun useFormValidation dari dasar terlebih dahulu, tim Anda mengerti persis siklus validasi reaktif di Vue 3 tanpa bergantung penuh pada sihir library pihak ketiga.

Diskusi & Komentar

0

Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.

Tulis Komentar
* Tautan dalam komentar otomatis diamankan dengan atribut rel="nofollow ugc". Maks 2.000 karakter
Komentar langsung terbit setelah lolos filter spam.

Belum Ada Komentar

Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!