Seriya: React Hook Form Dars 40

setValue() — Field qiymatini dasturiy o'zgartirish va opsiyalar

setValue() metodi sintaksisi, shouldDirty, shouldTouch, shouldValidate opsiyalari, avtomatik slug yaratish va shaklni to'ldirish amaliyoti.

40-dars

setValue() — Field qiymatini dasturiy o'zgartirish

setValue() — bu useForm() (yoki useFormContext()) qaytaradigan maxsus funksiya bo'lib, formadagi ro'yxatdan o'tgan maydon (yoki ichki/nested obyektlar hamda massivlar) qiymatini dasturiy yo'l bilan (programmatically) o'zgartirish imkonini beradi.

U odatda sarlavha asosida avtomatik slug (URL manzil) generatsiya qilish, tayyor shablon yoki namuna qiymatlarni joylash, tashqi modallar/rang tanlagichlardan qiymat qabul qilish yoki boshqa maydon qiymatini nusxalashda keng qo'llaniladi.


1. setValue() sintaksisi va konfiguratsiya opsiyalari

setValue() funksiyasi uchta argument qabul qiladi:

setValue(name, value, options?)

Odatiy holatda setValue("field", "yangi qiymat") chaqirilsa, React Hook Form faqat maydonning qiymatini o'zgartiradi, ammo formaning holatlarini (isDirty, touchedFields, errors) avtomatik yangilamaydi. Uchinchi argument (options) aynan shu harakatlarni boshqarish uchun xizmat qiladi:

Opsiya Turi Tavsifi va vazifasi
shouldDirty boolean true berilsa, qiymat defaultValues bilan solishtirilib, isDirty va dirtyFields qayta hisoblanadi.
shouldTouch boolean true berilsa, ushbu maydon touchedFields obyektida true deb belgilanadi.
shouldValidate boolean true berilsa, kiritilgan yangi qiymat uchun darhol validatsiya ishga tushadi, errors va isValid holatlari yangilanadi.

2. Real misol: Avtomatik slug yaratish va namunaviy to'ldirish

Quyidagi misolda loyiha nomi yozilganda slug maydoni avtomatik tarzda to'ldiriladi va har bir o'zgarishda validatsiya hamda isDirty holati faollashadi:

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

type ProjectFormValues = {
  name: string;
  slug: string;
};

// Matnni toza URL-mos slug formatiga o'tkazuvchi yordamchi funksiya
function toSlug(input: string): string {
  return input
    .toLowerCase()
    .trim()
    .replace(/[^a-z0-9\s-]/g, "")
    .replace(/\s+/g, "-")
    .replace(/-+/g, "-");
}

export function SetValueForm() {
  const {
    register,
    setValue,
    handleSubmit,
    formState: { errors, isDirty },
  } = useForm<ProjectFormValues>({
    defaultValues: {
      name: "",
      slug: "",
    },
  });

  // 1. Foydalanuvchi "name" ga yozganda "slug" qiymatini dasturiy belgilash
  const handleNameChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    const nextName = e.target.value;
    setValue("slug", toSlug(nextName), {
      shouldDirty: true,
      shouldValidate: true,
    });
  };

  // 2. Namunaviy ma'lumotlarni bitta tugma bilan joylash
  const handleFillDemo = () => {
    setValue("name", "Attendance Portal", {
      shouldDirty: true,
      shouldTouch: true,
      shouldValidate: true,
    });
    setValue("slug", "attendance-portal", {
      shouldDirty: true,
      shouldTouch: true,
      shouldValidate: true,
    });
  };

  const onSubmit: SubmitHandler<ProjectFormValues> = (data) => {
    console.log("Yaratilgan loyiha ma'lumotlari:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="projectName">Loyiha nomi</label>
        <input
          id="projectName"
          placeholder="Masalan: Attendance Portal"
          {...register("name", {
            required: "Loyiha nomi majburiy",
            onChange: handleNameChange,
          })}
        />
        {errors.name && (
          <p style={{ color: "red" }}>{errors.name.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="projectSlug">Slug (URL manzil)</label>
        <input
          id="projectSlug"
          placeholder="attendance-portal"
          {...register("slug", {
            required: "Slug kiritish majburiy",
            pattern: {
              value: /^[a-z0-9-]+$/,
              message: "Faqat kichik harflar, raqamlar va chiziqcha (-)",
            },
          })}
        />
        {errors.slug && (
          <p style={{ color: "red" }}>{errors.slug.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
        <button type="button" onClick={handleFillDemo}>
          Namunaviy qiymatlarni qo'yish
        </button>

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

3. Muhim amaliy eslatmalar

1. Standart holatda optionssiz holatlar yangilanmaydi

Agar siz shunchaki setValue("slug", "my-slug") deb chaqirsangiz, RHF qiymatni o'zgartiradi, ammo:

  • isDirty yangilanmasdan false qolishi mumkin (natijada submit tugmasi bloklangan holda qoladi).
  • Validatsiya tekshirilmaydi, shuning uchun eski errors yo'qolmasligi mumkin. Shu sababli, foydalanuvchi harakatiga bog'liq o'zgarishlarda har doim { shouldDirty: true, shouldValidate: true } opsiyalarini berish tavsiya etiladi.

2. Ro'yxatdan o'tmagan maydonlarga qiymat berish

setValue() orqali DOM'da hali register() qilinmagan maydon nomiga ham qiymat yozish mumkin. RHF bu ma'lumotni o'zining ichki holatida saqlab turadi va kelajakda o'sha nom bilan input register() orqali ulanganda unga avtomatik biriktiradi.