Series: React Hook Form Lesson 26

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?

  1. Maydon o'zgarganda: Foydalanuvchi title inputiga boshlang'ich qiymatdan boshqacha matn yozsa, dirtyFields.title === true bo'ladi.
  2. Asl holiga qaytganda: Agar foydalanuvchi yozganini o'chirib, yana boshlang'ich defaultValues.title holatiga keltirsa, dirtyFields.title obyektdan olib tashlanadi yoki false ga aylanadi.
  3. 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.