Series: React Hook Form Lesson 49

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.