Seriya: React Hook Form Dars 32

touchedFields — Foydalanuvchi kirib chiqqan (blur bo'lgan) maydonlarni aniqlash

touchedFields obyektining ishlashi, blur hodisalari, dirtyFields bilan taqqoslanishi, xatolarni faqat maydonga tegilgandan so'ng ko'rsatish (UX).

32-dars

touchedFields — Foydalanuvchi interaction qilgan field'lar

touchedFields — bu formState ichidagi maxsus obyekt bo'lib, foydalanuvchi qaysi inputlarga fokus berib, so'ngra undan chiqib ketganligini (blur hodisasi yuz berganini) ko'rsatadi.

Ko'pincha dasturchilar dirtyFields va touchedFields ni adashtiradilar:

  • dirtyFields — maydondagi qiymat defaultValues dan o'zgargan-o'zgarmaganini tekshiradi.
  • touchedFields — qiymat o'zgargan yoki o'zgarmaganidan qat'i nazar, foydalanuvchi o'sha input bilan o'zaro aloqa qilgani (tegib o'tgani) haqida ma'lumot beradi.

1. touchedFields qanday ishlaydi?

  1. Ilk yuklanish: Forma ochilganda barcha maydonlar uchun touchedFields.fieldName qiymati undefined (ya'ni false) bo'ladi.
  2. Yozish paytida: Foydalanuvchi inputga bosib yozsa ham, hali maydondan tashqariga chiqmagan bo'lsa, u hali touched hisoblanmaydi.
  3. Maydondan chiqilganda (onBlur): Foydalanuvchi boshqa elementga o'tishi bilan RHF touchedFields.fieldName = true deb belgilaydi (hatto inputga birorta harf yozilmagan bo'lsa ham).
  4. reset() chaqirilganda: reset() ishga tushishi bilan touchedFields obyekti yana butunlay tozalanadi.

2. dirtyFields vs touchedFields taqqoslanishi

Xususiyat Nimani tekshiradi? Qiymat o'zgarmasdan, shunchaki kirib chiqilsa (blur bo'lsa)?
touchedFields Inputga fokus qilinib chiqib ketilganini (blur bo'lganini). true bo'ladi.
dirtyFields Input qiymati defaultValues dan farqli ravishda o'zgarganini. undefined / false qoladi.

3. Real misol: Xatolikni faqat foydalanuvchi maydondan chiqqanda ko'rsatish (Yaxshi UX)

Foydalanuvchi hali emailni yozib tugatmasdan turib unga darhol "Email noto'g'ri" deb qizil xabar chiqarish yomon foydalanuvchi tajribasidir. touchedFields yordamida xatolikni faqat foydalanuvchi maydondan chiqqandan keyingina ko'rsatish mumkin:

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

type UserContactForm = {
  fullName: string;
  email: string;
};

export function TouchedFieldsForm() {
  const {
    register,
    handleSubmit,
    reset,
    formState: { errors, touchedFields, isSubmitting },
  } = useForm<UserContactForm>({
    mode: "onBlur", // onBlur hodisasida validatsiyadan o'tkazish
    defaultValues: {
      fullName: "",
      email: "",
    },
  });

  const onSubmit: SubmitHandler<UserContactForm> = async (data) => {
    console.log("Ma'lumotlar qabul qilindi:", data);
    reset(); // touchedFields ham tozalanadi
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. Ism maydoni */}
      <div>
        <label htmlFor="fullName">
          To'liq ism{" "}
          {touchedFields.fullName && (
            <span style={{ fontSize: "0.8rem", color: "#666" }}>(tegilgan)</span>
          )}
        </label>
        <input
          id="fullName"
          {...register("fullName", { required: "Ism kiritish majburiy" })}
          placeholder="Ismingizni kiriting"
        />
        {/* Faqat foydalanuvchi maydonga kirib chiqqanidan so'ng xatoni ko'rsatamiz */}
        {touchedFields.fullName && errors.fullName && (
          <p style={{ color: "red" }}>{errors.fullName.message}</p>
        )}
      </div>

      {/* 2. Email maydoni */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="email">
          Email manzil{" "}
          {touchedFields.email && (
            <span style={{ fontSize: "0.8rem", color: "#666" }}>(tegilgan)</span>
          )}
        </label>
        <input
          id="email"
          type="email"
          {...register("email", {
            required: "Email kiritish majburiy",
            pattern: {
              value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
              message: "Haqiqiy email manzilini kiriting",
            },
          })}
          placeholder="[email protected]"
        />
        {touchedFields.email && errors.email && (
          <p style={{ color: "red" }}>{errors.email.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1.5rem", display: "flex", gap: "10px" }}>
        <button type="submit" disabled={isSubmitting}>
          {isSubmitting ? "Yuborilmoqda..." : "Yuborish"}
        </button>

        <button type="button" onClick={() => reset()}>
          Formani tozalash
        </button>
      </div>
    </form>
  );
}

4. Muhim amaliy eslatmalar

  1. Proxy optimizatsiyasi: touchedFields foydalanuvchining har bir blur harakatida yangilanadi. Agar komponentingizda bu holat kerak bo'lmasa, uni formState dan ajratib olmang (destructure qilmang). Shunda komponent har safar inputdan chiqilganda behuda qayta render bo'lmaydi.

  2. mode: "onTouched" rejimi: Agar sizga har bir maydonda xatolik faqatgina birinchi marta inputdan chiqib ketilgandan keyin ko'rinishi, so'ngra yozish davomida real vaqtda tekshirib borilishi kerak bo'lsa, useForm({ mode: "onTouched" }) sozlamasidan foydalanish eng optimal yechim hisoblanadi.