Seriya: React Hook Form Dars 14

min va max — Sonli qiymatlar chegarasini belgilash va tekshirish

min va max qoidalarining ishlash mexanizmi, valueAsNumber bilan birga qo'llash, NaN xatolarini oldini olish hamda minLength/maxLength bilan farqi.

14-dars

min va max — Sonli qiymatlar chegarasini belgilash

min va max — bu sonli (yoki sana) qiymatlarning ruxsat etilgan eng quyi va eng yuqori chegarasini tekshirish uchun xizmat qiluvchi o'rnatilgan validatsiya qoidalaridir.

React Hook Form'da ularni { value, message } obyekti shaklida yozish xatolik matnlarini (errors.field.message) foydalanuvchiga aniq va tushunarli qilib ko'rsatish imkonini beradi.


1. Qanday ishlaydi?

  • min: Agar foydalanuvchi kiritgan son belgilangan qiymatdan kichik bo'lsa, xatolik yuzaga keladi (type: "min").
  • max: Agar kiritilgan son belgilangan qiymatdan katta bo'lsa, xatolik yuzaga keladi (type: "max").
  • valueAsNumber: true ning ahamiyati: Standart brauzer muhitida <input type="number" /> elementining qiymati JavaScript'ga matn (string, masalan "25") sifatida keladi. Matnlar ustida esa matematik taqqoslashlar xato ishlashi mumkin. Shu sababli har doim valueAsNumber: true opsiyasini qo'shish shart.

2. Real misol: Chegirma foizi va Xodimlar soni chegarasi

Quyidagi shaklda 0% dan 100% gacha bo'lgan chegirma miqdori va 1 dan 500 gacha bo'lgan xodimlar soni cheklovlari kiritilgan:

import { useForm, type SubmitHandler } from "react-hook-form";

type QuotaFormValues = {
  discountPercent: number;
  employeeCapacity: number;
};

export function MinMaxForm() {
  const {
    register,
    handleSubmit,
    formState: { errors },
  } = useForm<QuotaFormValues>({
    defaultValues: {
      discountPercent: 10,
      employeeCapacity: 50,
    },
  });

  const onSubmit: SubmitHandler<QuotaFormValues> = (data) => {
    console.log("Tasdiqlangan parametrlar:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. 0 dan 100 gacha chegirma foizi */}
      <div>
        <label htmlFor="discount">Chegirma foizi (%)</label>
        <input
          id="discount"
          type="number"
          {...register("discountPercent", {
            valueAsNumber: true,
            required: "Chegirma foizini kiritish majburiy",
            min: {
              value: 0,
              message: "Chegirma 0% dan kam bo'lishi mumkin emas",
            },
            max: {
              value: 100,
              message: "Chegirma 100% dan oshib ketmasligi kerak",
            },
          })}
          placeholder="10"
        />
        {errors.discountPercent && (
          <p style={{ color: "red" }}>{errors.discountPercent.message}</p>
        )}
      </div>

      {/* 2. 1 dan 500 gacha xodimlar sig'imi */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="capacity">Xodimlar sig'imi (kishi)</label>
        <input
          id="capacity"
          type="number"
          {...register("employeeCapacity", {
            valueAsNumber: true,
            required: "Xodimlar sonini kiriting",
            min: {
              value: 1,
              message: "Kompaniyada kamida 1 nafar xodim bo'lishi kerak",
            },
            max: {
              value: 500,
              message: "Maksimal sig'im 500 nafardan oshmasligi lozim",
            },
          })}
          placeholder="50"
        />
        {errors.employeeCapacity && (
          <p style={{ color: "red" }}>{errors.employeeCapacity.message}</p>
        )}
      </div>

      <button type="submit" style={{ marginTop: "1.5rem" }}>
        Saqlash
      </button>
    </form>
  );
}

3. Muhim amaliy jihatlar

1. Bo'sh qoldirilgan raqam inputi va NaN muammosi

Foydalanuvchi type="number" maydonidagi barcha raqamlarni o'chirib tashlasa, valueAsNumber: true sababli qiymat NaN ga aylanadi.

  • Agar maydon majburiy bo'lsa, required: "Raqam kiriting" bu xatolikni ushlab qoladi.
  • Agar qo'shimcha aniqlik zarur bo'lsa, maxsus validate qo'shish tavsiya etiladi:
    validate: (val) => !Number.isNaN(val) || "Iltimos, haqiqiy son kiriting"
    

2. Matn uzunligi va Son chegarasini adashtirmang

  • min va max: Faqat sonlar (masalan, yosh, narx, hajm) yoki sanalarning (Date) qiymatini solishtirish uchun ishlatiladi.
  • minLength va maxLength: Matnning (string) belgilar sonini (masalan, parol kamida 8 ta belgidan iborat bo'lishi) tekshirish uchun ishlatiladi.