Built-in Validation — React Hook Form ichki validatsiya mexanizmi
register ichidagi ichki validatsiya qoidalari (required, min, max, minLength, maxLength, pattern, validate), noValidate va valueAsNumber integratsiyasi.
49-dars
Built-in Validation — React Hook Form ichidagi validation mexanizmi
Built-in Validation — bu React Hook Form'ning hech qanday qo'shimcha tashqi kutubxonalarsiz (Zod, Yup, Valibot kabilarsiz) to'g'ridan-to'g'ri register(name, rules) orqali taqdim etiladigan ichki tekshiruv mexanizmidir.
U HTML5 standart atributlaridan (required, min, max, minLength, maxLength, pattern) ilhomlangan bo'lsa-da, brauzerning noqulay standart qalqib chiquvchi (native browser tooltip) xabarlariga tayanmaydi. Barcha xatoliklarni RHF o'zining reaktiv errors obyektiga yozadi, to'liq TypeScript bilan boshqariladi va istalgan dizayn tizimiga osongina moslashtiriladi.
1. Asosiy ichki validatsiya qoidalari
| Qoida | Nimani tekshiradi? | Qiymat ko'rinishi |
|---|---|---|
required |
Maydon bo'sh emasligini ("", false, null, undefined emasligini). |
string (xato matni), boolean yoki { value: true, message: "..." } |
min |
Sonli qiymatning minimal chegarasini (>=). |
number yoki { value: 18, message: "..." } |
max |
Sonli qiymatning maksimal chegarasini (<=). |
number yoki { value: 65, message: "..." } |
minLength |
Matn uzunligining minimal belgilar sonini. | number yoki { value: 3, message: "..." } |
maxLength |
Matn uzunligining maksimal belgilar sonini. | number yoki { value: 50, message: "..." } |
pattern |
Qiymatning muntazam ifodaga (RegExp) mosligini. | RegExp yoki { value: /^[A-Z]+$/, message: "..." } |
validate |
Maxsus sinxron yoki asinxron (async) tekshiruv funksiyasi. | (value, formValues) => boolean | string | Promise<...> |
2. Real misol: register() ichida barcha asosiy qoidalarni qo'llash
Quyidagi misolda yangi foydalanuvchi hisobini ro'yxatdan o'tkazish formasida barcha built-in qoidalar, jumladan parollarni solishtiruvchi validate funksiyasi birgalikda qo'llanilgan:
import { useForm, type SubmitHandler } from "react-hook-form";
type AccountRegisterFormValues = {
username: string;
email: string;
age: number;
password: string;
confirmPassword: string;
};
export function BuiltInValidationForm() {
const {
register,
handleSubmit,
getValues,
formState: { errors, isSubmitting },
} = useForm<AccountRegisterFormValues>({
defaultValues: {
username: "",
email: "",
age: 18,
password: "",
confirmPassword: "",
},
});
const onSubmit: SubmitHandler<AccountRegisterFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 500));
console.log("Yuborilgan ma'lumotlar:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Username: required, minLength, maxLength, pattern */}
<div>
<label htmlFor="biUsername">Username</label>
<input
id="biUsername"
placeholder="masalan: dev_user_01"
{...register("username", {
required: "Username kiritish majburiy",
minLength: {
value: 3,
message: "Kamida 3 ta belgi kiriting",
},
maxLength: {
value: 20,
message: "Ko'pi bilan 20 ta belgi kiriting",
},
pattern: {
value: /^[a-zA-Z0-9_]+$/,
message: "Faqat lotin harflari, raqamlar va pastki chiziq (_) mumkin",
},
})}
/>
{errors.username && (
<p style={{ color: "red" }} role="alert">
{errors.username.message}
</p>
)}
</div>
{/* 2. Email: required, pattern */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="biEmail">Email</label>
<input
id="biEmail"
type="email"
placeholder="[email protected]"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Email formati noto'g'ri kiritilgan",
},
})}
/>
{errors.email && (
<p style={{ color: "red" }} role="alert">
{errors.email.message}
</p>
)}
</div>
{/* 3. Yosh (raqam): valueAsNumber, min, max */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="biAge">Yosh</label>
<input
id="biAge"
type="number"
{...register("age", {
valueAsNumber: true,
required: "Yoshni ko'rsatish majburiy",
min: {
value: 16,
message: "Minimal yosh 16 bo'lishi kerak",
},
max: {
value: 99,
message: "Maksimal yosh 99 bo'lishi kerak",
},
})}
/>
{errors.age && (
<p style={{ color: "red" }} role="alert">
{errors.age.message}
</p>
)}
</div>
{/* 4. Parol: required, minLength */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="biPassword">Parol</label>
<input
id="biPassword"
type="password"
{...register("password", {
required: "Parol kiritish majburiy",
minLength: {
value: 8,
message: "Parol kamida 8 ta belgidan iborat bo'lishi kerak",
},
})}
/>
{errors.password && (
<p style={{ color: "red" }} role="alert">
{errors.password.message}
</p>
)}
</div>
{/* 5. Parolni tasdiqlash: validate yordamida solishtirish */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="biConfirmPassword">Parolni tasdiqlang</label>
<input
id="biConfirmPassword"
type="password"
{...register("confirmPassword", {
required: "Parolni qayta kiritish majburiy",
validate: (value) =>
value === getValues("password") || "Parollar bir-biriga mos kelmadi",
})}
/>
{errors.confirmPassword && (
<p style={{ color: "red" }} role="alert">
{errors.confirmPassword.message}
</p>
)}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.25rem" }}
>
{isSubmitting ? "Yuborilmoqda..." : "Ro'yxatdan o'tish"}
</button>
</form>
);
}
3. Muhim amaliy tavsiyalar
1. Doimo <form noValidate> atributidan foydalaning
Brauzerning standart HTML5 xatolik oynachalari ("Please fill in this field") React Hook Form xabarlari bilan to'qnashmasligi va forma ko'rinishi barcha qurilmalarda bir xil bo'lishi uchun har doim forma tegiga noValidate qo'yish kerak.
2. Sonli maydonlar uchun valueAsNumber: true shart
Brauzerlarda <input type="number" /> maydonining qiymati odatda matn (string) ko'rinishida olinadi. Agar valueAsNumber: true qo'yilmasa, min va max qoidalari son emas, matn uzunligi yoki alifbo tartibida xato taqqoslanishi mumkin.
3. Tashqi schema kutubxonalari bilan farqi
Kichik va o'rta loyihalar uchun Built-in validation qoidalari mutlaqo yetarli bo'lib, loyiha hajmiga (bundle size) ortiqcha kilobaytlar qo'shmaydi. Agar formalar juda ulkan bo'lsa yoki backend bilan umumiy DTO sxemalari bo'lishi talab qilinsa, kelgusi darslarda ko'rib chiqiladigan zodResolver kabi yechimlar qo'shiladi.