isValid — Formaning validatsiya holatini aniqlash va tugmalarni boshqarish
isValid qanday ishlaydi, mode (onChange, onBlur) bilan bog'liqligi, tugmalarni faollashtirish, asinxron validatsiyada isValidating va UX tavsiyalari.
27-dars
isValid — Form validation holati
isValid — bu formState ichidagi asosiy boolean indikatorlardan biri bo'lib, butun formadagi barcha ro'yxatdan o'tgan maydonlar belgilangan validatsiya qoidalariga to'liq mos kelishi yoki xatolar mavjudligini bildiradi.
Formada birorta ham xatolik bo'lmasa true, kamida bitta maydonda qoida buzilgan bo'lsa false qiymatini qaytaradi.
1. isValid qanday ishlaydi va mode sozlamasi bilan bog'liqligi
isValid qiymati validatsiya natijasiga to'g'ridan-to'g'ri bog'liq:
mode: "onSubmit"(Standart rejim): Ushbu rejimda validatsiya faqat foydalanuvchi "Yuborish" tugmasini bosgandagina ishlaydi. Shuning uchun sahifa dastlab ochilganda majburiy maydonlar bo'sh bo'lsa hamisValid: truebo'lib turishi mumkin (chunki hali tekshiruv o'tkazilmagan).mode: "onChange"yokimode: "onBlur": Agar sizga "Yuborish" yoki "Davom etish" tugmasini real vaqt rejimida (disabled={!isValid}) boshqarish kerak bo'lsa,useForm({ mode: "onChange" })sozlamasini berish shart. Shunda RHF har bir klavish bosilganda qoidalarni tekshiradi vaisValidni darhol yangilab boradi.
2. Real misol: mode: "onChange" bilan isValid orqali tugmani boshqarish
Quyidagi jamoaga a'zo taklif qilish shaklida to'g'ri email kiritilmaguncha tugmani faollashtirmaslik mexanizmini ko'ramiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type InviteMemberForm = {
email: string;
role: "member" | "admin";
};
export function IsValidExampleForm() {
const {
register,
handleSubmit,
formState: { isValid, errors },
} = useForm<InviteMemberForm>({
mode: "onChange", // isValid real vaqtda har bir o'zgarishda hisoblanishi uchun
defaultValues: {
email: "",
role: "member",
},
});
const onSubmit: SubmitHandler<InviteMemberForm> = (data) => {
console.log("Taklifnoma muvaffaqiyatli yuborildi:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="email">Foydalanuvchi emaili</label>
<input
id="email"
type="email"
placeholder="[email protected]"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Iltimos, to'g'ri formatdagi email kiriting",
},
})}
/>
{errors.email && <p style={{ color: "red" }}>{errors.email.message}</p>}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="role">Rol</label>
<select id="role" {...register("role")}>
<option value="member">A'zo (Member)</option>
<option value="admin">Administrator (Admin)</option>
</select>
</div>
{/* Faqat butun forma qoidalariga to'liq javob bergandagina tugma ochiladi */}
<button
type="submit"
disabled={!isValid}
style={{ marginTop: "1.5rem" }}
>
Taklif yuborish
</button>
</form>
);
}
3. Muhim amaliy jihatlar
1. Asinxron tekshiruvlar va isValidating
Agar formangizda server orqali tekshiriladigan asinxron qoidalar (validate: async (...)) yoki tashqi Zod resolverlar bo'lsa, tekshiruv serverda yakunlanguncha isValid vaqtincha false bo'lib turishi mumkin. Bunday paytda foydalanuvchiga tekshiruv ketayotganini bildirish uchun formState.isValidating boolean xususiyatidan foydalanish juda foydali.
2. UX (User Experience) nuqtai nazaridan tavsiya
Har doim ham yuborish tugmasini disabled={!isValid} qilib qo'yish foydalanuvchi tajribasi uchun yaxshi yechim bo'lmasligi mumkin:
- Ko'pincha foydalanuvchi forma nima sababdan yuborilmayotgani yoki qaysi maydonda xatolik borligini tushunmay qoladi.
- Shu sababli tugmani faol qoldirib, submit bosilganda xatoli maydonlarga e'tibor qaratish (fokus qilish yoki qizil xabar ko'rsatish) ko'p hollarda ancha tushunarliroq va qulayroq hisoblanadi.