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,
};
}

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
0Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.
Belum Ada Komentar
Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!