resetField() — Alohida maydonni reset qilish va boshlang'ich holatga qaytarish
resetField() sintaksisi, defaultValue va keep parametrlari, boshqa maydonlarni saqlagan holda bitta inputni tozalash amaliyoti.
42-dars
resetField() — Alohida field'ni reset qilish
resetField(name, options?) — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, butun formani emas, faqat bitta aniq maydonni (field) boshlang'ich (defaultValues) yoki siz ko'rsatgan yangi qiymatga qaytarish, shuningdek uning xatosi (errors), dirty va touched holatlarini tozalash imkonini beradi.
Agar formadagi boshqa inputlarda foydalanuvchi allaqachon ma'lumot yozgan bo'lsa, umumiy reset() chaqirish ularning barchasini o'chirib yuboradi. resetField() esa boshqa maydonlarga zarracha teginmasdan faqat tanlangan maydonni o'z holiga qaytaradi.
1. resetField() sintaksisi va konfiguratsiya opsiyalari
resetField() birinchi argument sifatida maydon nomini, ikkinchi argument sifatida ixtiyoriy opsiyalar obyektini qabul qiladi:
resetField("bio", {
defaultValue?: any,
keepError?: boolean,
keepDirty?: boolean,
keepTouched?: boolean,
});
| Parametr / Opsiya | Turi | Tavsifi va vazifasi |
|---|---|---|
name |
Path<T> |
Reset qilinadigan maydon nomi (masalan, "bio", "searchQuery" yoki ichki "user.email"). |
defaultValue |
FieldPathValue<T, N> |
Shu maydon uchun yangi boshlang'ich qiymatni o'rnatadi. |
keepError |
boolean |
true bo'lsa, ushbu maydonning validatsiya xatosi (errors[name]) o'chirilmay saqlanadi. |
keepDirty |
boolean |
true bo'lsa, dirtyFields obyektidagi o'zgarganlik holati saqlanib qoladi. |
keepTouched |
boolean |
true bo'lsa, touchedFields obyektidagi fokuslanganlik holati saqlanib qoladi. |
2. reset() vs resetField() taqqoslamasi
| Xususiyat | reset() |
resetField(name) |
|---|---|---|
| Ta'sir doirasi | Butun forma va barcha maydonlar. | Faqat ko'rsatilgan aniq bitta maydon. |
| Boshqa inputlar taqdiri | Hamma kiritilgan ma'lumotlar o'chiriladi. | Boshqa maydonlardagi yozuvlar saqlanib qoladi. |
| Global holatlar | submitCount, isSubmitted, isDirty global nollashtiriladi. |
Faqat o'sha maydonga tegishli holatlar tozalanadi. |
| Qachon qulay? | Forma yuborilgach yoki "Formani tozalash" tugmasida. | Qidiruv qatorini tozalash yoki bitta inputni asl holiga qaytarishda. |
3. Real misol: Boshqa maydonlarga tegmasdan faqat "Bio"ni tiklash
Quyidagi misolda foydalanuvchi to'liq ism va bio kiritgan bo'lsa ham, bitta tugma orqali faqat bio maydonini o'z boshlang'ich qiymatiga qaytarish yoki unga yangi default qiymat berish amaliyoti ko'rsatilgan:
import { useForm, type SubmitHandler } from "react-hook-form";
type ProfileBioFormValues = {
fullName: string;
bio: string;
};
export function ResetFieldExampleForm() {
const {
register,
resetField,
handleSubmit,
formState: { errors, dirtyFields },
} = useForm<ProfileBioFormValues>({
defaultValues: {
fullName: "Azizbek Karimov",
bio: "Frontend Developer | React, TypeScript",
},
});
// 1. Faqat "bio" maydonini useForm'dagi asl defaultValues qiymatiga qaytarish
const handleResetBio = () => {
resetField("bio");
};
// 2. "bio" maydoniga yangi boshlang'ich qiymat o'rnatish
const handleResetBioToCustom = () => {
resetField("bio", {
defaultValue: "Yangi bio matni",
});
};
const onSubmit: SubmitHandler<ProfileBioFormValues> = (data) => {
console.log("Saqlangan profil:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="profileFullName">To'liq ism</label>
<input
id="profileFullName"
{...register("fullName", { required: "Ism kiritish majburiy" })}
/>
{errors.fullName && (
<p style={{ color: "red" }}>{errors.fullName.message}</p>
)}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="profileBio">
Bio {dirtyFields.bio && <span style={{ color: "orange" }}>(o'zgargan)</span>}
</label>
<textarea
id="profileBio"
rows={3}
{...register("bio", {
maxLength: {
value: 160,
message: "Bio 160 belgidan oshmasligi kerak",
},
})}
/>
{errors.bio && (
<p style={{ color: "red" }} role="alert">
{errors.bio.message}
</p>
)}
</div>
<div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
<button type="button" onClick={handleResetBio}>
Bio'ni asl holatiga qaytarish
</button>
<button type="button" onClick={handleResetBioToCustom}>
Bio'ga yangi default qo'yish
</button>
<button type="submit">
Saqlash
</button>
</div>
</form>
);
}
4. Muhim amaliy maslahatlar
1. Qidiruv va filtr komponentlarida qulaylik
Ko'p maydonli filtrlash panelida (masalan: sana, kategoriya, narx, kalit so'z) har bir filtr maydoni yoniga kichik "x" (tozalash) tugmasi qo'yish odatiy hol. resetField("searchQuery") yordamida boshqa filtrlarni yo'qotmagan holda faqat o'sha inputni tozalash juda osonlashadi.
2. keepError qachon kerak?
Agar foydalanuvchi noto'g'ri qiymat kiritgach, siz maydonni tozalab bersangiz ham, xato matnini ogohlantirish sifatida ekranda saqlab qolmoqchi bo'lsangiz, resetField("field", { keepError: true }) opsiyasidan foydalanishingiz mumkin.