Seriya: React Hook Form Dars 12

Register Options — register() konfiguratsiyalari va transformatsiyalar

register(name, options) ning barcha konfiguratsiyalari: required, min/max, pattern, validate, valueAsNumber, valueAsDate, setValueAs va custom onChange.

12-dars

Register Options — register() konfiguratsiyalari

register(name, options) funksiyasining ikkinchi parametri (options) orqali nafaqat validatsiya qoidalarini o'rnatish, balki input qiymatlarini avtomatik transformatsiya qilish (masalan, stringdan number yoki Date'ga o'tkazish), hodisalarni tutish va maydonning faollik holatini boshqarish mumkin.


1. Asosiy konfiguratsiya variantlari jadvali

Parametr (Option) Vazifasi Misol / Izoh
required Maydon bo'sh bo'lmasligini tekshiradi required: "Ism kiritish majburiy"
minLength / maxLength Matn uzunligi chegarasini belgilaydi minLength: { value: 6, message: "Kamida 6 ta belgi" }
min / max Son yoki sana uchun minimal / maksimal chegara min: { value: 18, message: "18 yoshdan katta bo'lishi kerak" }
pattern Muntazam ifoda (RegExp) orqali tekshirish pattern: { value: /^[a-z0-9-]+$/, message: "Faqat kichik harf, raqam va '-'" }
validate Maxsus mantiqiy funksiya orqali tekshirish validate: (v) => v !== "admin" || "Bu login band"
valueAsNumber Qiymatni avtomatik number ga aylantiradi true bo'lsa, string emas, number (bo'sh bo'lsa NaN) qaytaradi
valueAsDate Sana maydonini JavaScript Date obyektiga aylantiradi true bo'lsa, Date obyekti sifatida olinadi
setValueAs Qiymatni ichki saqlash/yuborishdan oldin o'zgartiradi (val) => val.trim()
onChange / onBlur RHF'ning ichki mexanizmiga qo'shimcha hodisa tinglovchisi (e) => { console.log(e.target.value) }
disabled Maydonni o'chiradi va validatsiyadan chiqaradi true bo'lsa, qiymat yuborilganda undefined bo'ladi

2. Real misol: setValueAs, valueAsNumber, pattern va onChange

Quyidagi misolda kurs yaratish formasi keltirilgan. Unda sarlavha yozilganda onChange orqali slug avtomatik shakllantiriladi, narx va o'rinlar soni esa valueAsNumber orqali to'g'ri number tipiga o'giriladi:

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

type CourseFormValues = {
  title: string;
  price: number;
  slug: string;
  seats: number;
};

export function CourseRegisterOptionsForm() {
  const {
    register,
    handleSubmit,
    setValue,
    formState: { errors },
  } = useForm<CourseFormValues>({
    defaultValues: {
      title: "",
      price: 0,
      slug: "",
      seats: 10,
    },
  });

  const onSubmit: SubmitHandler<CourseFormValues> = (data) => {
    // data.price va data.seats — haqiqiy number tiplari
    // data.title va data.slug — tozalangan toza satrlar
    console.log("Yuboriladigan ma'lumot:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. setValueAs va qo'shimcha onChange hodisasi */}
      <div>
        <label htmlFor="title">Kurs nomi</label>
        <input
          id="title"
          {...register("title", {
            required: "Kurs nomi majburiy",
            setValueAs: (val: string) => val.trim(),
            onChange: (e) => {
              // Sarlavha yozilganda slug maydonini avtomatik to'ldirish
              const autoSlug = e.target.value
                .toLowerCase()
                .trim()
                .replace(/[^a-z0-9]+/g, "-")
                .replace(/^-|-$/g, "");

              setValue("slug", autoSlug, { shouldDirty: true, shouldValidate: true });
            },
          })}
          placeholder="React Hook Form kursi"
        />
        {errors.title && <p style={{ color: "red" }}>{errors.title.message}</p>}
      </div>

      {/* 2. pattern: faqat kichik lotin harflari, raqamlar va chiziqcha */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="slug">Slug (URL manzili)</label>
        <input
          id="slug"
          {...register("slug", {
            required: "Slug kiritish majburiy",
            pattern: {
              value: /^[a-z0-9-]+$/,
              message: "Faqat kichik harf, raqam va '-' belgisi ruxsat etiladi",
            },
          })}
          placeholder="react-hook-form-kursi"
        />
        {errors.slug && <p style={{ color: "red" }}>{errors.slug.message}</p>}
      </div>

      {/* 3. valueAsNumber va min validatsiyasi */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="price">Narxi (so'm)</label>
        <input
          id="price"
          type="number"
          {...register("price", {
            valueAsNumber: true,
            min: { value: 0, message: "Narx 0 dan kam bo'lishi mumkin emas" },
          })}
          placeholder="150000"
        />
        {errors.price && <p style={{ color: "red" }}>{errors.price.message}</p>}
      </div>

      {/* 4. valueAsNumber, min va max */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="seats">Mavjud joylar soni</label>
        <input
          id="seats"
          type="number"
          {...register("seats", {
            valueAsNumber: true,
            min: { value: 1, message: "Kamida 1 ta o'rin bo'lishi shart" },
            max: { value: 500, message: "Maksimal 500 ta o'rin ajratish mumkin" },
          })}
          placeholder="20"
        />
        {errors.seats && <p style={{ color: "red" }}>{errors.seats.message}</p>}
      </div>

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

3. Muhim amaliy jihatlar

1. valueAsNumber va bo'sh maydon holati (NaN)

Foydalanuvchi type="number" maydonidagi barcha raqamlarni o'chirib tashlasa, JavaScript input qiymatini bo'sh string "" deb oladi va valueAsNumber natijasida NaN (Not a Number) hosil bo'ladi.

  • Agar siz maydonga min yoki qo'shimcha validate qo'ygan bo'lsangiz, NaN holatini ham inobatga oling:
    validate: (v) => !Number.isNaN(v) || "To'g'ri son kiriting"
    

2. setValueAs vs vizual ko'rinish

  • setValueAs faqatgina React Hook Form ichidagi holatga (_formValues) va handleSubmit chaqirilganda qaytadigan data obyektiga ta'sir qiladi.
  • U foydalanuvchining ko'zi oldidagi brauzer inputining vizual matnini avtomatik o'zgartirmaydi.
  • Agar kiritilgan har bir harfni bevosita inputda ham formatlangan holda ko'rsatish talab qilinsa (masalan, telefon maskasi yoki karta raqami), setValue yoki Controller dan foydalanish to'g'riroq bo'ladi.