handleSubmit() — Form submit jarayonini to'liq boshqarish va xatolarni tutish
handleSubmit funksiyasining ishlashi: onValid va onInvalid callbacklari, isSubmitting asinxron boshqaruvi, setError bilan server xatolarini ko'rsatish va noValidate.
7-dars
handleSubmit() — Form submit jarayonini boshqarish
handleSubmit() — bu formani yuborish (submit) hodisasini to'liq o'z nazoratiga oladigan va validatsiya natijalariga qarab mos callback funksiyani ishga tushiradigan yuqori darajadagi wrapper funksiyadir.
Uning eng katta qulayliklaridan biri — <form onSubmit={...}> ichida har safar e.preventDefault() yozish shart emas; handleSubmit sahifa qayta yuklanishini avtomatik to'xtatadi va ma'lumotlarni tozalab beradi.
1. handleSubmit(onValid, onInvalid?) qanday ishlaydi?
handleSubmit ikkita argument qabul qiladi:
handleSubmit(onValid, onInvalid)
- Brauzer hodisasini to'xtatadi:
e.preventDefault()ni avtomatik chaqiradi. - Validatsiyani ishga tushiradi: Formadagi barcha ro'yxatdan o'tgan maydonlar va ulangan schema (Zod/Yup) qoidalarini bir vaqtning o'zida tekshiradi.
- Natijaga qarab ikkita yo'ldan birini tanlaydi:
- Xatolik bo'lmasa —
onValid(data, event): Forma to'liq to'g'ri to'ldirilgan bo'lsa, tozalangan va transformatsiya qilingandataobyekti bilanonValidfunksiyasini chaqiradi. AgaronValidasinxron (async/await) bo'lsa,formState.isSubmittingavtomatiktruega o'tadi va API so'rov tugagachfalsebo'ladi. - Xatolik bo'lsa —
onInvalid(errors, event): (Ixtiyoriy) Agar formadagi biror maydon validatsiyadan o'tmasa, barcha xatoliklar jamlanganerrorsobyektini qaytaradi. Bu analitika yozish, xabarnoma (toast) chiqarish yoki foydalanuvchini xatoli maydonga yo'naltirish uchun juda qulay.
- Xatolik bo'lmasa —
2. Real misol: onValid, onInvalid va API so'rov
Quyidagi misolda yangi loyiha yaratish shakli, pattern orqali URL tekshirish va serverdan qaytgan xatolikni setError("root.serverError") orqali ko'rsatishni ko'rib chiqamiz:
import { useForm, type SubmitErrorHandler, type SubmitHandler } from "react-hook-form";
type CreateProjectForm = {
title: string;
repositoryUrl: string;
};
export function CreateProjectForm() {
const {
register,
handleSubmit,
setError,
formState: { errors, isSubmitting },
} = useForm<CreateProjectForm>({
defaultValues: {
title: "",
repositoryUrl: "",
},
});
// 1. Validatsiya muvaffaqiyatli o'tganda ishlaydi
const onValid: SubmitHandler<CreateProjectForm> = async (data) => {
try {
// Masalan, backend API'ga ma'lumot yuborish
const response = await fetch("/api/projects", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data),
});
if (!response.ok) {
throw new Error("Server xatosi");
}
console.log("Loyiha muvaffaqiyatli yaratildi:", data);
} catch {
// Backend xatosini alohida maydonga emas, balki butun formaning "root" xatosiga biriktiramiz
setError("root.serverError", {
type: "server",
message: "Serverda xatolik yuz berdi. Iltimos, keyinroq qayta urinib ko'ring.",
});
}
};
// 2. Validatsiya xato berganda ishlaydi (ixtiyoriy)
const onInvalid: SubmitErrorHandler<CreateProjectForm> = (formErrors) => {
console.warn("Formada to'ldirilmagan yoki xato maydonlar bor:", formErrors);
};
return (
<form onSubmit={handleSubmit(onValid, onInvalid)} noValidate>
<div>
<label htmlFor="title">Loyiha nomi</label>
<input
id="title"
{...register("title", { required: "Loyiha nomi kiritilishi shart" })}
placeholder="Portfolio platformasi"
/>
{errors.title && <p style={{ color: "red" }}>{errors.title.message}</p>}
</div>
<div>
<label htmlFor="repositoryUrl">Repository manzili</label>
<input
id="repositoryUrl"
{...register("repositoryUrl", {
required: "Repository havolasi majburiy",
pattern: {
value: /^https?:\/\/.+/,
message: "Havola https:// bilan boshlanishi kerak",
},
})}
placeholder="https://github.com/username/project"
/>
{errors.repositoryUrl && (
<p style={{ color: "red" }}>{errors.repositoryUrl.message}</p>
)}
</div>
{/* Backend server xatoligi uchun umumiy ogohlantirish */}
{errors.root?.serverError && (
<div style={{ padding: "8px", background: "#ffebee", color: "#c62828" }}>
{errors.root.serverError.message}
</div>
)}
<button type="submit" disabled={isSubmitting}>
{isSubmitting ? "Yuborilmoqda..." : "Yaratish"}
</button>
</form>
);
}
3. Foydali amaliy tavsiyalar
1. noValidate atributi
Har doim formaga noValidate atributini qo'shing:
<form onSubmit={handleSubmit(onValid)} noValidate>
Bu brauzerning standart, tarjima qilib bo'lmaydigan va har bir operatsion tizimda har xil ko'rinadigan pop-up ogohlantirishlarini o'chiradi. Natijada xatolarni boshqarish to'liq sizning komponentlaringiz va RHF nazoratiga o'tadi.
2. Ikki marta bosishdan (Double Submit) himoyalanish
Foydalanuvchi tugmani ketma-ket bir necha marta bosib yuborishining oldini olish uchun:
onValidfunksiyasiniasync/awaitko'rinishida yozing.- Yuborish tugmasiga
disabled={isSubmitting}prop'ini bering. handleSubmitbirinchi asinxron so'rov tugamaguncha yangi submit jarayonini bloklaydi.
3. Server xatolarini setError("root") orqali ko'rsatish
Backenddan 400 yoki 500 status kodi kelganda, agar xatolik aniq bir inputga tegishli bo'lmasa, setError("root.serverError", { message: "..." }) dan foydalanish toza arxitekturani ta'minlaydi.