Seriya: React Hook Form Dars 23

unregister() — Maydonlarni dasturiy ravishda formadan chiqarish va o'chirish

unregister funksiyasining ishlashi, options (keepValue, keepError, keepDirty), shouldUnregister bilan farqlari va amaliy misol.

23-dars

unregister() — Field'ni formadan olib tashlash

unregister(name, options?) — bu React Hook Form tizimida avval ro'yxatdan o'tkazilgan (register qilingan) biror maydonni dasturiy yo'l bilan (kod orqali qo'lda) formadan chiqarish va o'chirish funksiyasidir.

Garchi komponent unmount bo'lganda bu jarayonni shouldUnregister avtomatik boshqarishi mumkin bo'lsa-da, komponent ekranda ko'rinib turgan holda ham uning qiymatini, xatolarini va validatsiya majburiyatlarini formadan butunlay soqit qilish kerak bo'lgan vaziyatlarda unregister() qo'l keladi.


1. unregister nima qiladi va qanday ishlaydi?

  1. Maydonni tizimdan chiqaradi: Ko'rsatilgan nomdagi inputni RHF ichki maydonlar ro'yxatidan o'chiradi.
  2. Submit'dan chiqaradi: handleSubmit(onValid) chaqirilganda, o'chirilgan maydon yakuniy data payload'ida qatnashmaydi.
  3. Validatsiya qoidalarini bekor qiladi: Maydonga biriktirilgan required, min yoki maxsus tekshiruvlar endi formani yuborishga to'sqinlik qilmaydi.

options parametrlari

Zaruriyat tug'ilganda maydon o'chirilayotganda uning ma'lum qismlarini saqlab qolish mumkin:

  • keepValue: true — Maydon ro'yxatdan chiqsa ham, uning qiymatini ichki xotirada saqlab qoladi.
  • keepError: true — Maydonning xatolik holatini saqlaydi.
  • keepDirty: true — Formadagi isDirty / dirtyFields holatini saqlab qoladi.
  • keepTouched: true — touchedFields holatini saqlaydi.

2. Real misol: Qo'shimcha maydonni qo'lda unregister() qilish

Tasavvur qiling, foydalanuvchi akkaunt yaratmoqda. U shaxsiy usernameni qo'lda kiritishi mumkin, ammo agar "Username'ni avtomatik yaratish" checkbox'ini tanlasa, maxsus username maydoni talab qilinmaydi va unregister("customHandle") orqali formadan olib tashlanadi:

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

type AccountFormValues = {
  autoGenerateHandle: boolean;
  customHandle?: string;
};

export function UnregisterFieldForm() {
  const {
    register,
    unregister,
    handleSubmit,
    formState: { errors },
  } = useForm<AccountFormValues>({
    defaultValues: {
      autoGenerateHandle: false,
      customHandle: "",
    },
  });

  const handleToggleAuto = (e: React.ChangeEvent<HTMLInputElement>) => {
    const isAuto = e.target.checked;
    if (isAuto) {
      // Maydonni va uning required xatolarini formadan chiqarib yuboramiz
      unregister("customHandle");
    }
  };

  const onSubmit: SubmitHandler<AccountFormValues> = (data) => {
    // Agar autoGenerateHandle true bo'lsa, data ichida customHandle qatnashmaydi
    console.log("Yuboriladigan ma'lumotlar:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label>
          <input
            type="checkbox"
            {...register("autoGenerateHandle", {
              onChange: handleToggleAuto,
            })}
          />
          Username'ni tizim tomonidan avtomatik yaratish
        </label>
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="customHandle">Maxsus username</label>
        <input
          id="customHandle"
          placeholder="masalan: super_coder"
          {...register("customHandle", {
            required: "Maxsus username kiritish majburiy",
          })}
        />
        {errors.customHandle && (
          <p style={{ color: "red" }}>{errors.customHandle.message}</p>
        )}
      </div>

      <button type="submit" style={{ marginTop: "1.5rem" }}>
        Akkauntni saqlash
      </button>
    </form>
  );
}

3. unregister() vs shouldUnregister — farqi nimada?

Mezon shouldUnregister: true unregister("fieldName")
Ishga tushish sharti Komponent React rendering daraxtidan unmount bo'lganda (DOM'dan yo'qolganda) avtomatik ishlaydi. Komponent hali ham DOM'da mavjud bo'lgan paytda ham hodisalar yoki biznes shartlar asosida dasturiy chaqiriladi.
Qo'llanish doirasi Shartli render bo'ladigan bloklar ({show && <Input />}) yoki Wizard qadamlari uchun. Murakkab dinamik mantiq, toggle, reset yoki ma'lumotlarni qo'lda tozalash uchun.