Series: React Hook Form Lesson 8

defaultValues — Form uchun boshlang'ich qiymatlarni to'g'ri belgilash

defaultValues nima uchun muhim: reset() ishlashi, isDirty aniqligi, statik va asinxron (async API) defaultValues hamda isLoading holati.

8-dars

defaultValues — Form uchun boshlang'ich qiymatlarni belgilash

defaultValues — bu useForm() hook'iga uzatiladigan konfiguratsiya obyekti (yoki asinxron funksiya) bo'lib, formadagi barcha maydonlarning boshlang'ich qiymatlarini belgilaydi.

Ko'pchilik uni shunchaki inputlarga boshlang'ich matn qo'yish vositasi deb o'ylaydi, biroq React Hook Form (RHF) arxitekturasida defaultValues bir qancha muhim ichki mexanizmlar to'g'ri ishlashi uchun poydevor hisoblanadi.


1. defaultValues nima uchun muhim?

  1. reset() funksiyasining to'g'ri ishlashi: Formada reset() chaqirilganda inputlar butunlay bo'shab qolmaydi, balki aynan siz defaultValues da belgilab qo'ygan boshlang'ich qiymatlarga qaytadi.

  2. isDirty va dirtyFields aniqligi: Foydalanuvchi biror inputga yozsa, RHF joriy qiymatni defaultValues bilan taqqoslaydi va agar farq bo'lsa isDirty: true qiladi. Agar foydalanuvchi kiritgan matnini o'chirib, yana boshlang'ich holatiga keltirsa, isDirty avtomatik ravishda yana false ga qaytadi.

  3. Controlled inputlar (Controller) uchun kafolat: Controller orqali ulangan tashqi komponentlarda value boshida undefined bo'lib qolishining oldini oladi. Natijada React konsolida "uncontrolled component is changing to be controlled" ogohlantirishi chiqmaydi.


2. Real misollar: Statik va Asinxron defaultValues

1. Statik defaultValues (Yangi element yaratish formasi)

Yangi ma'lumot qo'shish shakllarida boshlang'ich qiymatlar statik tarzda beriladi:

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

type TaskFormValues = {
  title: string;
  priority: "low" | "medium" | "high";
  completed: boolean;
};

export function CreateTaskForm() {
  const { register, handleSubmit, reset } = useForm<TaskFormValues>({
    defaultValues: {
      title: "",
      priority: "medium",
      completed: false,
    },
  });

  const onSubmit: SubmitHandler<TaskFormValues> = (data) => {
    console.log("Yangi vazifa saqlandi:", data);
    // Formani tozalab, yana defaultValues holatiga qaytaramiz
    reset();
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <div>
        <input
          {...register("title", { required: "Vazifa nomi majburiy" })}
          placeholder="Vazifa nomi"
        />
      </div>

      <div>
        <select {...register("priority")}>
          <option value="low">Past</option>
          <option value="medium">O'rta</option>
          <option value="high">Yuqori</option>
        </select>
      </div>

      <div>
        <label>
          <input type="checkbox" {...register("completed")} />
          Bajarildi deb belgilash
        </label>
      </div>

      <button type="submit">Qo'shish</button>
    </form>
  );
}

2. Asinxron defaultValues (Mavjud ma'lumotni tahrirlash formasi)

Tahrirlash (Edit) oynalarida ma'lumotlar serverdan API orqali biroz kechikib keladi. React Hook Form defaultValues ga to'g'ridan-to'g'ri async funksiya berishni qo'llab-quvvatlaydi.

Bunda RHF ma'lumot yuklanguncha formState.isLoading holatini o'zi boshqaradi:

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

type EditUserForm = {
  name: string;
  email: string;
};

export function EditUserForm({ userId }: { userId: string }) {
  const {
    register,
    handleSubmit,
    formState: { isLoading, isDirty, isSubmitting },
  } = useForm<EditUserForm>({
    // Asinxron tarzda serverdan ma'lumot olib kelish:
    defaultValues: async () => {
      const response = await fetch(`/api/users/${userId}`);
      if (!response.ok) {
        throw new Error("Foydalanuvchi ma'lumotlarini yuklab bo'lmadi");
      }
      return await response.json();
    },
  });

  const onSubmit: SubmitHandler<EditUserForm> = async (data) => {
    await fetch(`/api/users/${userId}`, {
      method: "PUT",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(data),
    });
    console.log("Ma'lumot yangilandi:", data);
  };

  // Ma'lumot kelguncha yuklanish indikatorini ko'rsatamiz
  if (isLoading) {
    return <p>Ma'lumotlar yuklanmoqda...</p>;
  }

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <div>
        <label>Ism</label>
        <input {...register("name")} placeholder="Ism" />
      </div>

      <div>
        <label>Email</label>
        <input {...register("email")} placeholder="Email" />
      </div>

      {/* Faqat foydalanuvchi ma'lumotni o'zgartirsagina tugma faollashadi */}
      <button type="submit" disabled={!isDirty || isSubmitting}>
        {isSubmitting ? "Saqlanmoqda..." : "Yangilash"}
      </button>
    </form>
  );
}

3. Muhim tavsiyalar

  1. Har bir maydon uchun boshlang'ich qiymat bering: Hech qachon biror maydonni defaultValues ichida tushirib qoldirmang. Har doim boshlang'ich qiymat sifatida bo'sh satr "", 0, false yoki null belgilang. Aks holda reset() va isDirty kutilmagan natija berishi mumkin.

  2. TanStack Query (React Query) bilan ishlash: Agar ma'lumotlaringiz allaqachon TanStack Query keshida yuklangan bo'lsa:

    • data mavjud bo'lganda useForm({ values: data }) yoki defaultValues: data qilib uzatish mumkin.
    • values parametri har safar kesh yangilanganda forma qiymatlarini avtomatik sinxronlashtirib turadi.