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—isDirtyvadirtyFieldsholatini 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.