Series: React Hook Form Lesson 25

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?

  1. Boshlang'ich holat: Forma ilk bor ochilib, defaultValues yuklanganda isDirty: false bo'ladi.
  2. Foydalanuvchi yozganda: Biror input qiymati o'zgarsa, RHF darhol isDirty: true holatiga o'tadi.
  3. Qayta tiklanganda: Agar foydalanuvchi kiritgan matnini o'chirib, yana boshlang'ich defaultValues holiga keltirsa, RHF buni aniqlaydi va isDirty yana avtomatik false ga qaytadi.
  4. reset(newValues) chaqirilganda: Serverga muvaffaqiyatli saqlangach reset(data) qilinsa, o'sha yangi ma'lumotlar yangi boshlang'ich nuqta bo'lib xizmat qiladi va isDirty yana false ga 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 savolga true/false javob 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.