field obyekti — value, onChange, onBlur, ref va name tahlili
Controller va useController field obyekti, 5 ta asosiy xususiyat, onChange transformatsiyalari va ref orqali fokus boshqaruvi.
62-dars
field Object — value, onChange, onBlur, ref, name
field obyekti — bu <Controller render={({ field }) => ...} /> komponenti va useController() hooki taqdim etadigan asosiy obyekt bo'lib, controlled yoki maxsus (custom) UI komponentni React Hook Form'ning ichki holati, validatsiya sikli va fokus boshqaruvi bilan bog'laydigan asosiy ko'prik (bridge) vazifasini bajaradi.
Oddiy register() chaqirilganda barcha xususiyatlar bitta obyekt ichida kelib, inputga spread qilib ({...register("name")}) yuboriladi. field obyekti esa har bir ulanish nuqtasini (value, onChange, onBlur, ref, name) alohida, aniq va to'liq nazorat ostida uzatish imkoniyatini taqdim etadi.
1. field obyektining 5 ta asosiy xususiyati
| Xususiyat | Turi | Vazifasi | E'tiborga molik jihati |
|---|---|---|---|
value |
FieldPathValue<T, N> |
Maydonning RHF ichki xotirasidagi joriy qiymati. | Controlled inputning value (yoki checkbox uchun checked) propiga beriladi. defaultValues da boshlang'ich qiymat berish shart. |
onChange |
(...event: any[]) => void |
Qiymat o'zgarganda RHF'ga xabar beradi hamda validatsiya va isDirty holatlarini yangilaydi. |
Ham odatdagi DOM ChangeEvent ni, ham to'g'ridan-to'g'ri yangi qiymatni (nextValue) qabul qila oladi. |
onBlur |
() => void |
Maydon fokusdan chiqqanini RHF'ga bildiradi (touchedFields va mode: "onBlur" uchun). |
Komponent fokusdan chiqqanda (onBlur) chaqirilishi kerak. |
ref |
RefCallback<any> |
DOM elementi yoki komponentga ref ulaydi. | setFocus() chaqirilganda yoki submitda xato chiqqanda (shouldFocusError) kursor aynan shu ref orqali inputga tushadi. |
name |
FieldPath<T> |
Maydonning formadagi to'liq yo'li (masalan: "email", "profile.bio"). |
HTML name, id yoki aria-labelledby atributlarini bog'lashda qo'llaniladi. |
2. Real misol: 5 ta xususiyatni to'liq ishlatish va field.ref orqali fokus
Quyidagi misolda field obyektining barcha 5 ta xususiyati qo'lda aniq uzatiladi, qiymat kiritilayotganda field.onChange orqali kichik harflarga o'giriladi hamda tashqi tugma orqali setFocus("nickname") chaqirilganda field.ref yordamida kursor avtomatik inputga olib kelinadi:
import { Controller, useForm, type SubmitHandler } from "react-hook-form";
type NicknameFormValues = {
nickname: string;
};
export function FieldObjectDemoForm() {
const {
control,
setFocus,
handleSubmit,
formState: { errors, isSubmitting },
} = useForm<NicknameFormValues>({
mode: "onBlur",
defaultValues: {
nickname: "",
},
});
const onSubmit: SubmitHandler<NicknameFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 300));
console.log("Yuborilgan nickname:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="fieldNickname" style={{ display: "block", fontWeight: 600 }}>
Foydalanuvchi taxallusi (Nickname)
</label>
<Controller
name="nickname"
control={control}
rules={{
required: "Nickname kiritish majburiy",
minLength: {
value: 3,
message: "Kamida 3 ta belgi kiriting",
},
}}
render={({ field }) => (
<input
id="fieldNickname"
// 1. name - maydon identifikatori
name={field.name}
// 2. value - joriy boshqariluvchi qiymat
value={field.value}
// 3. ref - fokus boshqaruvi uchun
ref={field.ref}
// 4. onBlur - fokusdan chiqish hodisasi
onBlur={field.onBlur}
// 5. onChange - qiymatni o'zgartirish va transformatsiya
onChange={(e) => {
// Matnni kichik harflarga aylantirib RHF'ga uzatamiz
field.onChange(e.target.value.toLowerCase().trim());
}}
placeholder="masalan: dev_bro"
style={{
marginTop: "4px",
padding: "8px 12px",
border: "1px solid #cbd5e1",
borderRadius: "6px",
width: "260px",
}}
/>
)}
/>
{errors.nickname && (
<p style={{ color: "red", margin: "4px 0 0 0" }} role="alert">
{errors.nickname.message}
</p>
)}
</div>
<div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
{/* field.ref orqali inputga fokus berish */}
<button type="button" onClick={() => setFocus("nickname")}>
Inputga fokus berish (via field.ref)
</button>
<button type="submit" disabled={isSubmitting}>
Saqlash
</button>
</div>
</form>
);
}
3. Muhim amaliy qoidalar
1. onChange moslashuvchanligi va ma'lumotni tozalash
field.onChange aqlli funksiya bo'lib:
field.onChange(e)— oddiy React event obyektini ham taniydi vae.target.valueni o'zi ajratib oladi;field.onChange("yangi_matn")— primitiv qiymat yoki obyektni ham to'g'ridan-to'g'ri qabul qiladi. Agar qiymatni saqlashdan oldin formatlash (masalan:toLowerCase(),Number(val)yoki probellarni olib tashlash) kerak bo'lsa, uni yuqoridagi misoldagidekonChange={(e) => field.onChange(...)}ichida amalga oshirish juda qulay.
2. ref ulanmasa nima bo'ladi?
Agar siz field.ref ni DOM elementiga ulamasangiz:
setFocus("nickname")chaqirilganda xatolik yuz bermaydi, lekin kursor inputga tushmaydi;- Submit paytida validatsiya xatosi chiqqanda RHF birinchi xato maydonga avtomatik kursor olib bora olmaydi (
shouldFocusError: trueishlamaydi).
3. field va fieldState farqi
field— faqatgina ma'lumot almashinuvi (qiymat, hodisalar va ref) uchun javobgar;fieldState— maydonning holati (xato bormi:error, foydalanuvchi kirdimi:isTouched, qiymat o'zgardimi:isDirty) haqidagi ma'lumotlarni beradi.