Seriya: React Hook Form Dars 27

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:

  1. mode: "onSubmit" (Standart rejim): Ushbu rejimda validatsiya faqat foydalanuvchi "Yuborish" tugmasini bosgandagina ishlaydi. Shuning uchun sahifa dastlab ochilganda majburiy maydonlar bo'sh bo'lsa ham isValid: true bo'lib turishi mumkin (chunki hali tekshiruv o'tkazilmagan).
  2. mode: "onChange" yoki mode: "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 va isValid ni 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.