Series: React Hook Form Lesson 41

reset() — Form qiymatlari va holatlarini boshlang'ich holatga qaytarish

reset() metodining chaqirish usullari, keepOptions parametrlari, API ma'lumotlarini yuklash va submitdan so'ng formani tozalash amaliyoti.

41-dars

reset() — Form qiymatlarini boshlang'ich holatga qaytarish

reset() — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, formadagi maydon qiymatlari, validatsiya xatolari (errors) hamda formState holatlarini (isDirty, dirtyFields, touchedFields, isSubmitted, submitCount) boshlang'ich yoki yangi belgilangan qiymatlarga qaytarish uchun ishlatiladi.

U asosan "Bekor qilish / Tozalash" tugmasida, forma muvaffaqiyatli yuborilgandan keyin inputlarni bo'shatishda yoki API orqali serverdan yuklangan ma'lumotlarni tahrirlash (edit) formasiga joylashda qo'llaniladi.


1. reset() ni chaqirish usullari

Chaqirish usuli Nimani bajaradi? Qachon ishlatiladi?
reset() (argumentsiz) Formani useForm({ defaultValues }) dagi asl qiymatlarga qaytaradi va xato/dirty/touched holatlarini tozalaydi. "Bekor qilish" yoki formani dastlabki holatga qaytarish tugmasida.
reset(newValues) Maydon qiymatlarini newValues ga o'zgartiradi va ularni yangi defaultValues deb belgilaydi (isDirty → false). API'dan ma'lumot yuklanganda yoki saqlangandan keyin yangi bazani o'rnatishda.
reset(values, keepOptions) Ayrim holatlarni saqlab qolgan holda reset qiladi (masalan, { keepIsSubmitSuccessful: true }). Muvaffaqiyat xabarini ekranda qoldirib, faqat inputlarni tozalashda.

keepOptions parametrlari:

  • keepErrors: true — Mavjud xatoliklarni (errors) tozalamay qoldiradi.
  • keepDirty: true — isDirty va dirtyFields holatini saqlab qoladi.
  • keepValues: true — Joriy kiritilgan qiymatlarni o'zgartirmay, faqat holatlarni tozalaydi.
  • keepIsSubmitted: true — Forma yuborilganlik holatini (isSubmitted) true holda saqlaydi.
  • keepIsSubmitSuccessful: true — Muvaffaqiyatli yuborilganlik statusini saqlab qoladi.
  • keepSubmitCount: true — Submit urinishlari hisoblagichini nollashtirmaydi.

2. Real misol: Tozalash, shablon yuklash va keepIsSubmitSuccessful

Quyidagi misolda vazifa qo'shilgach, muvaffaqiyat xabari yo'qolib ketmasligi uchun { keepIsSubmitSuccessful: true } bilan tozalash hamda tashqi shablon qiymatlarini yuklashni ko'ramiz:

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

type TaskFormValues = {
  title: string;
  assignee: string;
};

const INITIAL_TASK_VALUES: TaskFormValues = {
  title: "",
  assignee: "Frontend Team",
};

export function ResetFormExample() {
  const {
    register,
    handleSubmit,
    reset,
    formState: { errors, isDirty, isSubmitSuccessful, isSubmitting },
  } = useForm<TaskFormValues>({
    defaultValues: INITIAL_TASK_VALUES,
  });

  // 1. Submit muvaffaqiyatli yakunlangach formani tozalash
  const onSubmit: SubmitHandler<TaskFormValues> = async (data) => {
    await new Promise((resolve) => setTimeout(resolve, 500));
    console.log("Vazifa saqlandi:", data);

    // Inputlarni dastlabki holatga qaytaradi, lekin isSubmitSuccessful xabarini saqlab qoladi
    reset(INITIAL_TASK_VALUES, { keepIsSubmitSuccessful: true });
  };

  // 2. Shablon yuklanganda yangi qiymatlarni defaultValues deb belgilash
  const handleLoadPreset = () => {
    reset({
      title: "Router guards tekshiruvi",
      assignee: "Auth Module",
    });
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="taskTitle">Vazifa nomi</label>
        <input
          id="taskTitle"
          placeholder="Masalan: Login validatsiyasini qo'shish"
          {...register("title", { required: "Vazifa nomi majburiy" })}
        />
        {errors.title && (
          <p style={{ color: "red" }}>{errors.title.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="taskAssignee">Mas'ul guruh</label>
        <input
          id="taskAssignee"
          {...register("assignee", { required: "Mas'ul guruh majburiy" })}
        />
        {errors.assignee && (
          <p style={{ color: "red" }}>{errors.assignee.message}</p>
        )}
      </div>

      {isSubmitSuccessful && (
        <div style={{ marginTop: "1rem", color: "green", fontWeight: 600 }}>
          Vazifa muvaffaqiyatli saqlandi!
        </div>
      )}

      <div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
        <button type="submit" disabled={isSubmitting}>
          {isSubmitting ? "Saqlanmoqda..." : "Saqlash"}
        </button>

        <button type="button" onClick={() => reset()} disabled={!isDirty}>
          Bekor qilish
        </button>

        <button type="button" onClick={handleLoadPreset}>
          Shablon yuklash
        </button>
      </div>
    </form>
  );
}

3. Muhim amaliy eslatmalar

1. API'dan kelgan ma'lumotlar bilan reset(apiData)

Agar tahrirlash sahifasida ma'lumotlar asinxron tarzda fetch/axios orqali yuklansa, ma'lumot kelishi bilan reset(apiData) chaqirish eng ishonchli usuldir. Bu barcha inputlarni to'ldiradi va yangi kelgan ma'lumotlarni formaning defaultValues bazasi sifatida qabul qiladi (natijada isDirty yana to'g'ri ishlaydi).

(Yoki zamonaviy React Hook Form versiyalarida useForm({ values: apiData }) propidan foydalanish ham mumkin).

2. handleSubmit(onSubmit) ichida chaqirish tartibi

Agar onSubmit ichida reset() chaqirilsa, u to'liq submit sikli tugagach holatni tozalaydi. Agar siz onSubmit dan so'ng yana boshqa amallarni bajarsangiz yoki formadagi ma'lumotlarni o'qimoqchi bo'lsangiz, reset() chaqirilganidan keyin getValues() dastlabki holatga qaytib qolgan bo'lishini hisobga oling.