Validation Modes — onSubmit, onBlur, onChange, onTouched va all tahlili
useForm mode konfiguratsiyasi, validatsiya ishga tushish bosqichlari, UX tavsiyalari va reValidateMode bilan o'zaro farqlari.
55-dars
Validation Modes — onSubmit, onBlur, onChange, onTouched, all
Validation Modes (Validatsiya rejimlari) — bu useForm({ mode: ... }) konfiguratsiyasida belgilanadigan sozlama bo'lib, formadagi tekshiruv qoidalari foydalanuvchi harakatining qaysi bosqichida birinchi marta ishga tushishini (trigger bo'lishini) belgilaydi.
React Hook Form'da sukut bo'yicha (default) qiymat "onSubmit" hisoblanadi. Bu foydalanuvchi hali birinchi harfni yozishni boshlagan zahoti qizil xatolarga ko'milmasligini ta'minlab, foydalanuvchi tajribasini (UX) asrashga xizmat qiladi.
1. Asosiy mode qiymatlari taqqoslamasi
mode qiymati |
Qachon validatsiya ishga tushadi? | Qaysi holatlarda eng qulay? |
|---|---|---|
"onSubmit" (default) |
Forma yuborilgan (submit bosilgan) paytda birinchi marta tekshiriladi. Shundan so'ng xatoli maydonlar reValidateMode (default: onChange) bo'yicha qayta tekshirib boriladi. |
Katta va standart formalarda foydalanuvchini yozish jarayonida chalg'itmaslik uchun eng yaxshi amaliyot. |
"onBlur" |
Foydalanuvchi maydon ichidan tashqariga chiqqanda (blur hodisasida) tekshiriladi. | Email, username, karta raqami kabi maydonlarni foydalanuvchi yozib bo'lgach tekshirishda juda qulay. |
"onChange" |
Inputga har bir harf yozilganda yoki o'chirilganda darhol tekshiriladi. | Jonli ko'rsatkichlar (masalan: parol kuchi indikatori, qolgan belgilar soni) yoki qisqa 1-2 maydonli formalarda. |
"onTouched" |
Inputga birinchi marta kirib chiqilguncha (blur) jim turadi, shundan so'ng har bir change hodisasida real vaqtda tekshiradi. |
Zo'r UX beradi: foydalanuvchi inputdan chiqib ketgach xato ko'rinadi, lekin xatoni tuzatayotganda bir zumda yo'qoladi. |
"all" |
Ham onBlur, ham onChange hodisalarida uzluksiz tekshiruv olib boradi. |
Barcha o'zgarish va fokus chiqishlarida qat'iy nazorat talab etiladigan maxsus maydonlarda. |
2. Real misol: Validatsiya rejimlarini interaktiv sinab ko'rish
Quyidagi misolda mode parametrini interaktiv o'zgartirib, har bir rejim foydalanuvchi kiritishiga qanday munosabat bildirishini ko'rishingiz mumkin:
import { useState } from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
type ValidationModeOption = "onSubmit" | "onBlur" | "onChange" | "onTouched" | "all";
type ModeDemoFormValues = {
username: string;
email: string;
};
export function ValidationModesDemoForm() {
const [mode, setMode] = useState<ValidationModeOption>("onSubmit");
const {
register,
handleSubmit,
formState: { errors, isSubmitting },
} = useForm<ModeDemoFormValues>({
// key={mode} mode o'zgarganda formani yangi sozlama bilan qayta yuklash uchun
key: mode,
mode,
defaultValues: {
username: "",
email: "",
},
});
const onSubmit: SubmitHandler<ModeDemoFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 400));
console.log(`[${mode}] rejimi bilan yuborildi:`, data);
};
return (
<div>
{/* Rejimni tanlash paneli */}
<div style={{ marginBottom: "1.25rem", padding: "10px", background: "#f1f5f9", borderRadius: "6px" }}>
<label htmlFor="modeSelect" style={{ fontWeight: 600 }}>
Validation Mode rejimini tanlang:{" "}
</label>
<select
id="modeSelect"
value={mode}
onChange={(e) => setMode(e.target.value as ValidationModeOption)}
style={{ padding: "4px 8px" }}
>
<option value="onSubmit">onSubmit (default - tavsiya etiladi)</option>
<option value="onBlur">onBlur (maydondan chiqqanda)</option>
<option value="onChange">onChange (har bir harfda)</option>
<option value="onTouched">onTouched (birinchi blur'dan so'ng)</option>
<option value="all">all (blur va change birgalikda)</option>
</select>
</div>
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="vmUsername">Username</label>
<input
id="vmUsername"
placeholder="Kamida 3 ta belgi"
{...register("username", {
required: "Username kiritish majburiy",
minLength: {
value: 3,
message: "Kamida 3 ta belgi kiriting",
},
})}
/>
{errors.username && (
<p style={{ color: "red" }} role="alert">
{errors.username.message}
</p>
)}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="vmEmail">Email</label>
<input
id="vmEmail"
type="email"
placeholder="[email protected]"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Email formati noto'g'ri",
},
})}
/>
{errors.email && (
<p style={{ color: "red" }} role="alert">
{errors.email.message}
</p>
)}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.25rem" }}
>
Yuborish
</button>
</form>
</div>
);
}
3. Muhim amaliy tavsiyalar
1. reValidateMode bilan uyg'unlik
mode faqat birinchi tekshiruv qachon boshlanishini belgilaydi. Agar maydonda xatolik aniqlansa, foydalanuvchi uni to'g'irlayotganida qaysi rejimda qayta tekshirilishini reValidateMode sozlamasi boshqaradi (sukut bo'yicha "onChange"). Bu juda to'g'ri logika: xato aniqlanguncha foydalanuvchini bezovta qilmaymiz, lekin xato chiqqach, uni to'g'irlashi bilan qizil yozuv yo'qoladi.
2. Asinxron (API) validatsiyalarda onChange dan saqlaning
Agar maydonda serverga so'rov yuboruvchi validate: async () => ... qoidasi bo'lsa, hech qachon mode: "onChange" ishlatmang! Har bir klaviatura bosilganda backend serveringizga yuzlab keraksiz so'rovlar yuboriladi. Asinxron tekshiruvlar uchun har doim onBlur yoki onSubmit rejimlarini tanlang.