dirtyFields — Aynan qaysi maydonlar o'zgarganini aniqlash va PATCH so'rovlar
dirtyFields obyektining ishlashi, maydonlar bo'yicha o'zgarishlarni kuzatish, PATCH so'rovlarida faqat o'zgargan ma'lumotlarni yuborish va nested strukturalar.
26-dars
dirtyFields — O'zgartirilgan field'larni aniqlash
dirtyFields — bu formState ichidagi maxsus obyekt bo'lib, formadagi aynan qaysi maydonlar (fields) defaultValues da berilgan boshlang'ich qiymatdan farqli ravishda o'zgartirilganini ko'rsatadi.
isDirty butun forma uchun umumiy boolean (true/false) ma'lumot bersa, dirtyFields har bir maydon kesimida (field-by-field) aniq tahlil qilish imkonini yaratadi.
1. dirtyFields qanday ishlaydi?
- Maydon o'zgarganda: Foydalanuvchi
titleinputiga boshlang'ich qiymatdan boshqacha matn yozsa,dirtyFields.title === truebo'ladi. - Asl holiga qaytganda: Agar foydalanuvchi yozganini o'chirib, yana boshlang'ich
defaultValues.titleholatiga keltirsa,dirtyFields.titleobyektdan olib tashlanadi yokifalsega aylanadi. - Eng katta amaliy foydasi:
- PATCH so'rovlari: Backend'ga butun formaning barcha 50 ta maydonini qaytadan yubormasdan, faqatgina foydalanuvchi o'zgartirgan 1–2 ta maydonni ajratib olib yuborish (payload optimizatsiyasi).
- Vizual indikatorlar: Foydalanuvchiga aynan qaysi maydonlar tahrirlanganini ko'rsatuvchi belgilar (badge) chiqarish.
2. Real misol: dirtyFields orqali faqat o'zgargan maydonlarni ajratish (PATCH)
Quyidagi maqolani tahrirlash shaklida o'zgargan maydonlarni belgilash va serverga faqat o'zgargan parametrlarni ajratib jo'natishni ko'ramiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type ArticleEditValues = {
title: string;
summary: string;
};
export function DirtyFieldsForm() {
const {
register,
handleSubmit,
reset,
formState: { dirtyFields, isDirty },
} = useForm<ArticleEditValues>({
defaultValues: {
title: "TanStack Router qo'llanmasi",
summary: "Feature-based struktura bo'yicha qisqa sharh",
},
});
const onSubmit: SubmitHandler<ArticleEditValues> = (data) => {
// Faqat dirtyFields da true bo'lgan maydonlarni ajratib olamiz
const changedPayload: Partial<ArticleEditValues> = {};
(Object.keys(dirtyFields) as Array<keyof ArticleEditValues>).forEach(
(key) => {
if (dirtyFields[key]) {
changedPayload[key] = data[key];
}
}
);
console.log("Formaning barcha ma'lumotlari:", data);
console.log("PATCH uchun faqat o'zgargan ma'lumotlar:", changedPayload);
// Muvaffaqiyatli saqlangach joriy qiymatlarni yangi defaultValues qilamiz
reset(data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="title">
Sarlavha{" "}
{dirtyFields.title && (
<span style={{ color: "#f57c00", fontSize: "0.85rem" }}>
(o'zgartirildi)
</span>
)}
</label>
<input id="title" {...register("title")} />
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="summary">
Qisqacha mazmun{" "}
{dirtyFields.summary && (
<span style={{ color: "#f57c00", fontSize: "0.85rem" }}>
(o'zgartirildi)
</span>
)}
</label>
<textarea id="summary" {...register("summary")} />
</div>
<button type="submit" disabled={!isDirty} style={{ marginTop: "1.5rem" }}>
O'zgarishlarni saqlash
</button>
</form>
);
}
3. Muhim amaliy eslatmalar
1. defaultValues mavjudligi shart
dirtyFields barcha taqqoslashlarni defaultValues bilan qiyoslagan holda amalga oshiradi. Agar siz defaultValues ni ko'rsatmagan bo'lsangiz, dirtyFields kutilganidek to'g'ri ishlamasligi mumkin.
2. Ichma-ich joylashgan (Nested) obyektlar va massivlar
Agar formangizda chuqur joylashgan obyektlar (user.profile.name) yoki massivlar (items.0.price) bo'lsa, dirtyFields ham xuddi shu tuzilmani takrorlaydi:
{
"user": {
"profile": {
"name": true
}
},
"items": [
{
"price": true
}
]
}
Bu murakkab strukturalarda ham aniq qaysi element o'zgarganini xatosiz aniqlashga xizmat qiladi.