keepDirtyValues — Reset paytida o'zgartirilgan maydon qiymatlarini saqlash
keepDirtyValues opsiyasi, dirty va non-dirty maydonlar farqi, fon yangilanishlarida foydalanuvchi yozgan ma'lumotlarini asrab qolish va keepDirty bilan farqi.
48-dars
keepDirtyValues — Reset vaqtida o'zgartirilgan qiymatlarni saqlash
keepDirtyValues — bu reset(values, { keepDirtyValues: true }) funksiya chaqiruvida yoki useForm({ values, resetOptions: { keepDirtyValues: true } }) konfiguratsiyasida ishlatiladigan boolean parametrdir.
U forma reset qilinganda yoki yangi tashqi ma'lumotlar bilan qayta to'ldirilganda, foydalanuvchi tomonidan o'zgartirilgan (dirty) maydonlarning joriy qiymatlarini o'chirib yubormasdan saqlab qoladi. Faqatgina foydalanuvchi teginmagan (non-dirty) maydonlar yangi kelgan qiymatlarga yangilanadi.
Bu imkoniyat foydalanuvchi formani to'ldirib turgan vaqtda fonda yangi server ma'lumotlari kelib tushsa (masalan, davriy so'rovlar — polling, WebSocket hodisalari yoki auto-refetch holatlarida), foydalanuvchi kiritgan qimmatli matnlarni yo'qotmaslik uchun beqiyosdir.
1. keepDirtyValues mexanizmi qanday ishlaydi?
Faraz qilaylik, formangizda title va body maydonlari mavjud:
- Dastlab ikkala maydonda ham boshlang'ich server qiymatlari turibdi.
- Foydalanuvchi faqat
bodymaydoniga yangi matn kiritdi:dirtyFields.body = true(o'zgartirilgan / dirty)dirtyFields.title = undefined(o'zgartirilmagan / pristine)
- Fonda serverdan yangilangan ma'lumotlar keldi va
keepDirtyValues: truebilan reset bo'ldi:body— dirty bo'lgani sababli, foydalanuvchi kiritgan matn o'zgarishsiz qoladi.title— dirty bo'lmagani sababli, serverdan kelgan yangi sarlavha bilan avtomatik yangilanadi.
2. keepDirtyValues vs keepDirty taqqoslamasi
Ko'pincha bu ikki parametr nomi o'xshash bo'lgani sababli chalkashtiriladi:
| Opsiya | Nimani boshqaradi? | Tavsifi |
|---|---|---|
keepDirtyValues |
Qiymatni (Value) | O'zgartirilgan maydondagi foydalanuvchi yozgan haqiqiy matn yoki qiymatni o'chirishdan asraydi. |
keepDirty |
Holat belgisini (Boolean Flag) | formState.isDirty va dirtyFields obyektining true ekanligi belgisini saqlab qoladi. |
[!TIP] Ko'p hollarda server bilan uzluksiz sinxronlashda ikkalasini birgalikda qo'llash mantiqiy jihatdan eng to'g'ri yondashuv hisoblanadi:
{ keepDirtyValues: true, keepDirty: true }.
3. Real misol: Fon yangilanishida foydalanuvchi matnini saqlab qolish
Quyidagi misolda serverdan yangi ma'lumot kelganda faqat foydalanuvchi o'zgartirmagan maydon yangilanadi, o'zgartirilgan maydon esa o'z holicha saqlanib qoladi:
import { useState } from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
type PostDraftValues = {
title: string;
body: string;
};
export function KeepDirtyValuesForm() {
const [serverData, setServerData] = useState<PostDraftValues>({
title: "Dastlabki sarlavha",
body: "Dastlabki matn",
});
const {
register,
reset,
handleSubmit,
formState: { dirtyFields, errors },
} = useForm<PostDraftValues>({
values: serverData,
resetOptions: {
keepDirtyValues: true, // O'zgartirilgan matnlarni asrab qoladi
},
});
// 1. Fonda serverdan yangi ma'lumotlar kelishini simulyatsiya qilish
const handleIncomingServerUpdate = () => {
setServerData({
title: "Serverdan yangilangan yangi sarlavha",
body: "Serverdan yangilangan yangi matn",
});
};
// 2. Barcha kiritilgan o'zgarishlarni bekor qilib, server qiymatlariga majburiy qaytarish
const handleForceResetAll = () => {
reset(serverData, { keepDirtyValues: false });
};
const onSubmit: SubmitHandler<PostDraftValues> = (data) => {
console.log("Saqlangan post ma'lumotlari:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="kdvTitle">
Sarlavha{" "}
{dirtyFields.title && <span style={{ color: "orange" }}>(o'zgartirilgan)</span>}
</label>
<input
id="kdvTitle"
{...register("title", { required: "Sarlavha kiritish majburiy" })}
/>
{errors.title && (
<p style={{ color: "red" }} role="alert">
{errors.title.message}
</p>
)}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="kdvBody">
Matn{" "}
{dirtyFields.body && <span style={{ color: "orange" }}>(o'zgartirilgan)</span>}
</label>
<textarea
id="kdvBody"
rows={3}
{...register("body", { required: "Matn kiritish majburiy" })}
/>
{errors.body && (
<p style={{ color: "red" }} role="alert">
{errors.body.message}
</p>
)}
</div>
<div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem", flexWrap: "wrap" }}>
<button type="button" onClick={handleIncomingServerUpdate}>
Server yangilanishini simulyatsiya qilish
</button>
<button type="button" onClick={handleForceResetAll}>
Barchasini server qiymatiga qaytarish
</button>
<button type="submit">
Saqlash
</button>
</div>
</form>
);
}
4. Muhim amaliy tavsiyalar
1. Majburiy to'liq qaytarish (Force Reset)
Agar foydalanuvchi "Barcha o'zgarishlarni bekor qilish" tugmasini bossa, keepDirtyValues: false qilib reset() chaqirish kerak. Aks holda keepDirtyValues: true tufayli forma foydalanuvchi yozgan ma'lumotlarni o'chirmay qoldiradi.
2. Kolaborativ (ko'p foydalanuvchili) interfeyslar
Agar bir nechta operator bir vaqtning o'zida bitta yozuv ustida ishlayotgan bo'lsa, keepDirtyValues: true operator o'zi tahrirlayotgan inputlarni saqlagan holda, boshqa operatorlar o'zgartirgan qo'shni maydonlarni real vaqtda qabul qilib turish imkonini beradi.