Series: React Hook Form Lesson 55

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.