Series: React Hook Form Lesson 47

resetOptions — Reaktiv values yangilanganda forma holatlarini boshqarish

useForm resetOptions opsiyasi, keepDirtyValues, keepDirty, keepTouched parametrlari va server ma'lumotlari yangilanganda foydalanuvchi kiritmalarini saqlab qolish.

47-dars

resetOptions — Reset jarayonidagi qiymatlarni boshqarish

resetOptions — bu useForm({ values, resetOptions }) konfiguratsiyasida belgilanadigan maxsus parametr bo'lib, tashqi reaktiv values (masalan, serverdan yoki TanStack Query / Redux'dan kelgan ma'lumotlar) o'zgarganda avtomatik reset jarayoni qanday kechishini va qaysi formState holatlari saqlab qolinishini belgilaydi.

Oddiy reset(newValues, keepOptions) chaqiruvi faqatgina o'sha bir martalik qo'lda qilingan resetga ta'sir qilsa, resetOptions useForm darajasidagi doimiy qoida hisoblanadi. Bu foydalanuvchi formada nimadir yozib turgan paytda tashqi ma'lumotlar fonga kelib yangilansa, foydalanuvchi kiritgan o'zgarishlar (dirtyFields) yoki tekshirib ko'rilgan xatolar bexosdan o'chib ketmasligi uchun xizmat qiladi.


1. resetOptions tarkibidagi asosiy parametrlar (KeepStateOptions)

Kalit Turi Nimani saqlab qoladi? Qachon foydali?
keepDirtyValues boolean Foydalanuvchi o'zgartirgan (dirty) maydon qiymatlarini saqlaydi. Serverdan yangi ma'lumot kelganda foydalanuvchi yozib turgan matn ustiga yozib yubormaslik uchun.
keepDirty boolean dirtyFields va isDirty holatini saqlab qoladi. Qaysi maydonlar o'zgarganligi belgisini yo'qotmaslik uchun.
keepTouched boolean touchedFields holatini saqlab qoladi. Foydalanuvchi allaqachon kirib chiqqan maydonlar statusini saqlashda.
keepErrors boolean Mavjud validatsiya xatolarini (errors) tozalab tashlamaydi. Yangi ma'lumot kelganda xato ogohlantirishlarini ekranda qoldirishda.
keepIsSubmitted boolean isSubmitted holatini saqlab qoladi. Forma kamida bir marta submit qilinganligini bilishda.
keepSubmitCount boolean submitCount (urinishlar soni) hisoblagichini nollashtirmaydi. Foydalanuvchi harakatlari statistikasini yo'qotmaslikda.
keepIsSubmitSuccessful boolean isSubmitSuccessful statusini saqlab qoladi. Muvaffaqiyat xabarlarini bexosdan o'chirib yubormaslikda.

2. Real misol: Serverdan ma'lumot sinxronlanganda foydalanuvchi yozuvlarini saqlab qolish

Quyidagi misolda values sifatida tashqi serverProfile obyekti ulangan. resetOptions: { keepDirtyValues: true, keepDirty: true, keepTouched: true } yordamida backenddan yangi ma'lumot kelganda ham foydalanuvchi o'zgartirgan maydonlar xavfsiz saqlanadi:

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

type ProfileSettingsValues = {
  fullName: string;
  bio: string;
};

const INITIAL_SERVER_PROFILE: ProfileSettingsValues = {
  fullName: "Muhammadjon Meliqo'ziyev",
  bio: "Frontend Developer",
};

export function ResetOptionsForm() {
  const [serverProfile, setServerProfile] =
    useState<ProfileSettingsValues>(INITIAL_SERVER_PROFILE);

  const {
    register,
    handleSubmit,
    reset,
    formState: { errors, dirtyFields, touchedFields, isDirty },
  } = useForm<ProfileSettingsValues>({
    // Tashqi reaktiv qiymatlar bog'langan
    values: serverProfile,
    // values o'zgarganda avtomatik reset jarayoni uchun doimiy qoidalar
    resetOptions: {
      keepDirtyValues: true, // Foydalanuvchi o'zgartirgan qiymatlarni o'chirmay saqlaydi
      keepDirty: true,       // dirtyFields va isDirty flagini yo'qotmaydi
      keepTouched: true,     // touchedFields holatini saqlab qoladi
    },
  });

  // Serverdan ma'lumotlarni qayta yuklash (Polling yoki WebSocket ssenariysi)
  const handleSyncFromServer = () => {
    setServerProfile({
      fullName: "Muhammadjon Meliqo'ziyev",
      bio: "Frontend Developer • React & TypeScript Specialist",
    });
  };

  const onSubmit: SubmitHandler<ProfileSettingsValues> = (data) => {
    setServerProfile(data);
    // Saqlangandan so'ng dirty holatlarini nollashtirish
    reset(data, { keepDirty: false, keepDirtyValues: false });
    console.log("Saqlangan sozlamalar:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="roFullName">
          To'liq ism{" "}
          {dirtyFields.fullName && <span style={{ color: "orange" }}>(dirty)</span>}{" "}
          {touchedFields.fullName && <span style={{ color: "blue" }}>(touched)</span>}
        </label>
        <input
          id="roFullName"
          {...register("fullName", { required: "Ism kiritish majburiy" })}
        />
        {errors.fullName && (
          <p style={{ color: "red" }} role="alert">
            {errors.fullName.message}
          </p>
        )}
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="roBio">
          Bio{" "}
          {dirtyFields.bio && <span style={{ color: "orange" }}>(dirty)</span>}{" "}
          {touchedFields.bio && <span style={{ color: "blue" }}>(touched)</span>}
        </label>
        <textarea id="roBio" rows={3} {...register("bio")} />
      </div>

      <div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
        <button type="button" onClick={handleSyncFromServer}>
          Serverdan yangi values yuklash
        </button>

        <button type="submit" disabled={!isDirty}>
          Saqlash
        </button>
      </div>
    </form>
  );
}

3. Muhim amaliy eslatmalar

1. values va resetOptions uyg'unligi

resetOptions odatda values reaktiv parametri bilan birgalikda qo'llaniladi. Agar siz values bermasdan faqat bir martalik defaultValues ishlatsangiz, resetOptions harakatga kelmaydi.

2. reset(values, keepOptions) bilan farqi

  • resetOptions (useForm konfiguratsiyasida): tashqi values o'zgarganda avtomatik ishga tushadigan qoidalar to'plami.
  • reset(values, options) (funksiya chaqiruvida): aynan o'sha bir martalik chaqiruv paytida ishlaydigan lokal parametr.