Series: React Hook Form Lesson 62

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 va e.target.value ni 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 misoldagidek onChange={(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: true ishlamaydi).

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.