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
minyoki qo'shimchavalidateqo'ygan bo'lsangiz,NaNholatini ham inobatga oling:validate: (v) => !Number.isNaN(v) || "To'g'ri son kiriting"
2. setValueAs vs vizual ko'rinish
setValueAsfaqatgina React Hook Form ichidagi holatga (_formValues) vahandleSubmitchaqirilganda qaytadigandataobyektiga 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),
setValueyokiControllerdan foydalanish to'g'riroq bo'ladi.