Series: React Hook Form Lesson 24

formState — Forma holatini to'liq boshqarish va Proxy optimizatsiyasi

formState xususiyatlari: errors, isSubmitting, isDirty, isValid, dirtyFields, touchedFields, Proxy obunasi va reset imkoniyatlari.

24-dars

formState — Form holatini boshqarish

formState — bu useForm() (yoki useFormContext()) qaytaradigan maxsus reaktiv obyekt bo'lib, formaning joriy holati haqidagi barcha muhim ma'lumotlarni beradi: validatsiya xatolari, serverga so'rov ketish jarayoni, foydalanuvchi qaysi maydonlarni o'zgartirgani (isDirty), qaysi biriga kirib chiqqani (touchedFields) va formaning umumiy to'g'riligi (isValid).


1. Eng ko'p ishlatiladigan formState xususiyatlari

Xususiyat Tipi Ma'nosi va Vazifasi
errors FieldErrors<T> Validatsiyadan o'tmagan maydonlar xatolari (message, type, ref).
isSubmitting boolean handleSubmit ichidagi asinxron so'rov davom etayotganda true bo'ladi. Tugmani bloklash (disable) va yuklanish indikatorini chiqarish uchun qulay.
isSubmitted boolean Forma kamida bir marta yuborishga urinilgan bo'lsa true bo'ladi (reset() chaqirilguncha).
isSubmitSuccessful boolean Oxirgi submit operatsiyasi xatolarsiz muvaffaqiyatli yakunlangan bo'lsa true bo'ladi.
isDirty boolean Kamida bitta maydon qiymati defaultValues dan farqli ravishda o'zgartirilgan bo'lsa true.
dirtyFields Partial<Record<keyof T, boolean>> Anan qaysi maydonlar o'zgartirilganini ko'rsatuvchi xarita.
touchedFields Partial<Record<keyof T, boolean>> Foydalanuvchi qaysi inputlarga kirib chiqqanini (blur bo'lganini) ko'rsatadi.
isValid boolean Formada hech qanday validatsiya xatosi bo'lmasa true bo'ladi.
isLoading boolean defaultValues asinxron funksiya sifatida berilganda, u serverdan yuklanguncha true bo'ladi.

2. Real misol: isDirty, isSubmitting, isSubmitSuccessful va errors

Sozlamalar formasida ma'lumot faqat o'zgargandagina saqlash tugmasini yoqish, so'rov paytida tugmani bloklash va muvaffaqiyat xabarini ko'rsatishni amalga oshiramiz:

import { useForm, type SubmitHandler } from "react-hook-form";

type SettingsFormValues = {
  workspaceName: string;
  contactEmail: string;
};

export function FormStateExample() {
  const {
    register,
    handleSubmit,
    reset,
    formState: {
      errors,
      isDirty,
      isSubmitting,
      isSubmitSuccessful,
    },
  } = useForm<SettingsFormValues>({
    defaultValues: {
      workspaceName: "MuSa Falah",
      contactEmail: "[email protected]",
    },
  });

  const onSubmit: SubmitHandler<SettingsFormValues> = async (data) => {
    // API so'rov simulyatsiyasi (600ms)
    await new Promise((resolve) => setTimeout(resolve, 600));
    console.log("Muvaffaqiyatli saqlandi:", data);

    // Saqlangan qiymatlarni yangi defaultValues sifatida mustahkamlaymiz:
    // Natijada isDirty yana false holatiga qaytadi
    reset(data, { keepIsSubmitSuccessful: true });
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. Ish maydoni nomi */}
      <div>
        <label htmlFor="workspaceName">Ish maydoni nomi</label>
        <input
          id="workspaceName"
          {...register("workspaceName", { required: "Ish maydoni nomi majburiy" })}
        />
        {errors.workspaceName && (
          <p style={{ color: "red" }}>{errors.workspaceName.message}</p>
        )}
      </div>

      {/* 2. Aloqa emaili */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="contactEmail">Aloqa emaili</label>
        <input
          id="contactEmail"
          type="email"
          {...register("contactEmail", {
            required: "Email kiritilishi shart",
          })}
        />
        {errors.contactEmail && (
          <p style={{ color: "red" }}>{errors.contactEmail.message}</p>
        )}
      </div>

      {/* Muvaffaqiyatli saqlanganda xabarnoma */}
      {isSubmitSuccessful && !isDirty && (
        <div style={{ padding: "8px", background: "#e8f5e9", color: "#2e7d32", marginTop: "1rem" }}>
          O'zgarishlar muvaffaqiyatli saqlandi!
        </div>
      )}

      {/* Faqat o'zgarish kiritilgan bo'lsa va so'rov ketmayotgan bo'lsa faol bo'ladi */}
      <button
        type="submit"
        disabled={!isDirty || isSubmitting}
        style={{ marginTop: "1.5rem" }}
      >
        {isSubmitting ? "Saqlanmoqda..." : "Saqlash"}
      </button>
    </form>
  );
}

3. Muhim arxitekturaviy jihatlar

1. Faqat kerakli xususiyatlarni destructuring qiling

formState ichki arxitekturada JavaScript Proxy mexanizmi orqali ishlaydi.

  • RHF faqatgina siz komponentda o'qigan (destructure qilgan) xususiyatlarni kuzatadi.
  • Masalan, agar siz faqat errors va isSubmitting ni ajratib olgan bo'lsangiz, foydalanuvchi yozganda isDirty yoki dirtyFields o'zgarsa ham komponentingiz ortiqcha qayta render qilinmaydi.

2. isValid va mode sozlamasi

  • Agar formangizda mode: "onSubmit" (standart holat) bo'lsa, isValid dastlabki render paytida noto'g'ri (ko'pincha false) ko'rinishi yoki forma birinchi marta submit qilinmaguncha o'zgarmasligi mumkin.
  • Agar sizga real vaqtda har bir klavish bosilganda to'g'ri ishlovchi isValid (masalan, formani to'g'ri to'ldirmaguncha tugmani nofaol qilib turish) kerak bo'lsa, mode: "onChange" yoki mode: "onBlur" sozlamasidan foydalaning.