isDirty — Formada o'zgarishlar borligini aniqlash va boshqarish
isDirty qanday ishlaydi, defaultValues bilan bog'liqligi, saqlanmagan o'zgarishlarni bekor qilish, reset bilan sinxronlashtirish va dirtyFields bilan farqi.
25-dars
isDirty — Form qiymatlari o'zgarganini aniqlash
isDirty — bu formState ichidagi eng qulay va muhim boolean xususiyatlardan biri bo'lib, formadagi kamida bitta maydon qiymati defaultValues da belgilangan boshlang'ich qiymatdan farqli ravishda o'zgartirilgan yoki o'zgarmaganligini real vaqt rejimida bildiradi.
U asosan "Saqlash" tugmasini faqat o'zgarish kiritilgandagina faollashtirish, saqlanmagan o'zgarishlar haqida foydalanuvchini ogohlantirish yoki "Bekor qilish" tugmasini boshqarishda qo'llaniladi.
1. isDirty qanday ishlaydi?
- Boshlang'ich holat: Forma ilk bor ochilib,
defaultValuesyuklangandaisDirty: falsebo'ladi. - Foydalanuvchi yozganda: Biror input qiymati o'zgarsa, RHF darhol
isDirty: trueholatiga o'tadi. - Qayta tiklanganda: Agar foydalanuvchi kiritgan matnini o'chirib, yana boshlang'ich
defaultValuesholiga keltirsa, RHF buni aniqlaydi vaisDirtyyana avtomatikfalsega qaytadi. reset(newValues)chaqirilganda: Serverga muvaffaqiyatli saqlangachreset(data)qilinsa, o'sha yangi ma'lumotlar yangi boshlang'ich nuqta bo'lib xizmat qiladi vaisDirtyyanafalsega tushadi.
2. Real misol: O'zgarish bo'lmasa tugmani bloklash va reset() bilan sinxronlashtirish
Quyidagi domen sozlamalari shaklida o'zgarish mavjudligini ko'rsatish, saqlash va bekor qilish mantiqlarini ko'rib chiqamiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type DomainSettingsForm = {
siteName: string;
customDomain: string;
};
export function IsDirtyForm() {
const {
register,
handleSubmit,
reset,
formState: { isDirty, isSubmitting },
} = useForm<DomainSettingsForm>({
defaultValues: {
siteName: "dev-bro",
customDomain: "dev-bro.uz",
},
});
const onSubmit: SubmitHandler<DomainSettingsForm> = async (data) => {
console.log("Yangi qiymatlar serverga saqlanmoqda:", data);
// API so'rov simulyatsiyasi
await new Promise((resolve) => setTimeout(resolve, 500));
// Saqlangan qiymatlarni yangi defaultValues qilib belgilaymiz:
// Natijada isDirty yana false holatiga tushadi
reset(data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="siteName">Sayt nomi</label>
<input id="siteName" {...register("siteName")} />
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="customDomain">Domen manzili</label>
<input id="customDomain" {...register("customDomain")} />
</div>
{/* Foydalanuvchiga saqlanmagan o'zgarishlar borligini bildirish */}
{isDirty && (
<p style={{ color: "#f57c00", fontWeight: 500, marginTop: "1rem" }}>
Diqqat: Saqlanmagan o'zgarishlar mavjud.
</p>
)}
<div style={{ marginTop: "1.5rem", display: "flex", gap: "10px" }}>
{/* Faqat o'zgarish kiritilgan bo'lsa va so'rov ketmayotgan bo'lsa tugma bosiladi */}
<button type="submit" disabled={!isDirty || isSubmitting}>
{isSubmitting ? "Saqlanmoqda..." : "Saqlash"}
</button>
{/* O'zgarishlarni bekor qilib dastlabki holatga qaytarish */}
<button type="button" disabled={!isDirty} onClick={() => reset()}>
Bekor qilish
</button>
</div>
</form>
);
}
3. Muhim amaliy eslatmalar
1. defaultValues kiritilishi shart
isDirty to'g'ri va xatosiz ishlashi uchun useForm ichida barcha maydonlarning defaultValues boshlang'ich qiymatlarini aniq ko'rsatish shart. Aks holda RHF joriy qiymatni nima bilan solishtirishni bilmaydi va isDirty noaniq ishlashi mumkin.
2. isDirty vs dirtyFields farqi
isDirty(boolean): Butun formaning umumiy holati. Formada kamida 1 ta o'zgarish bormi yoki yo'qmi degan savolgatrue/falsejavob beradi.dirtyFields(object): Aynan qaysi maydonlar o'zgartirilganligini alohida-alohida ko'rsatadi (masalan,{ customDomain: true }). Bu serverga faqat o'zgargan maydonlarni (PATCH so'rovida) yuborish uchun juda asqotadi.