Series: React Hook Form Lesson 20

setValueAs — Qiymatlarni maxsus transformatsiya qilish va tozalash

setValueAs opsiyasi bilan ma'lumotlarni o'zgartirish: trim qilish, vergulli matnni massivga aylantirish, bo'sh satrni null qilish va vizual ko'rinish farqi.

20-dars

setValueAs — Qiymatni custom transform qilish

setValueAs — bu register() parametrining eng qulay transformatsiya opsiyasi bo'lib, foydalanuvchi kiritayotgan qiymatni validatsiya qoidalariga va onSubmit(data) payload'iga yetib borguncha o'zingiz istagan formatga o'zgartirish (transform / sanitize qilish) imkonini beradi.

Masalan:

  • Matn boshidagi va oxiridagi bo'sh joylarni tozalash (trim());
  • Vergul bilan ajratilgan bitta matnni massivga (string[]) aylantirish;
  • Bo'sh qolgan matnni "" o'rniga ma'lumotlar bazasiga mos tarzda null ga o'tkazish.

1. Qanday ishlaydi?

  1. Foydalanuvchi yozadi yoki o'zgartiradi: Input hodisasi yuz berishi bilan RHF setValueAs(value) funksiyasini chaqiradi.
  2. Transformatsiya qilingan qiymat ichki xotiraga yoziladi: Yangilangan qiymat RHF ichki holatida saqlanadi.
  3. Validatsiya va Submit shu qiymat bilan ishlaydi: Keyingi barcha tekshiruvlar (validate, required) va handleSubmit dagi yakuniy data obyekti aynan siz o'zgartirgan ko'rinishda qabul qilinadi.

2. Real misol: trim(), Teglarni massivga o'tkazish va Bo'sh qiymatni null qilish

Quyidagi maqola yaratish shaklida uch xil amaliy transformatsiya qo'llanishini ko'rib chiqamiz:

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

type ArticleFormValues = {
  title: string;
  tags: string[];
  canonicalUrl: string | null;
};

export function SetValueAsForm() {
  const {
    register,
    handleSubmit,
    formState: { errors },
  } = useForm<ArticleFormValues>({
    defaultValues: {
      title: "",
      tags: [],
      canonicalUrl: null,
    },
  });

  const onSubmit: SubmitHandler<ArticleFormValues> = (data) => {
    // data.title -> trim qilingan toza string
    // data.tags -> ["react", "typescript", "rhf"] (haqiqiy massiv)
    // data.canonicalUrl -> bo'sh bo'lsa null, aks holda toza URL satri
    console.log("Transformatsiya qilingan yakuniy data:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. Sarlavhadagi keraksiz bo'sh joylarni trim qilish */}
      <div>
        <label htmlFor="title">Maqola sarlavhasi</label>
        <input
          id="title"
          {...register("title", {
            required: "Sarlavha kiritish majburiy",
            setValueAs: (value: string) => value.trim(),
          })}
          placeholder="React Hook Form arxitekturasi"
        />
        {errors.title && <p style={{ color: "red" }}>{errors.title.message}</p>}
      </div>

      {/* 2. Vergul bilan kiritilgan matnni string[] massivga aylantirish */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="tags">Teglar (vergul bilan ajrating)</label>
        <input
          id="tags"
          placeholder="react, typescript, frontend"
          {...register("tags", {
            setValueAs: (value: string | string[]) => {
              if (Array.isArray(value)) return value;
              return value
                .split(",")
                .map((tag) => tag.trim().toLowerCase())
                .filter(Boolean); // Bo'sh elementlarni chiqarib tashlaymiz
            },
            validate: (tags) =>
              tags.length > 0 || "Kamida 1 ta haqiqiy teg kiriting",
          })}
        />
        {errors.tags && <p style={{ color: "red" }}>{errors.tags.message}</p>}
      </div>

      {/* 3. Bo'sh qolgan ixtiyoriy satrni null ga aylantirish */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="canonicalUrl">Asl maqola havolasi (Ixtiyoriy)</label>
        <input
          id="canonicalUrl"
          placeholder="https://example.com/original-post"
          {...register("canonicalUrl", {
            setValueAs: (value: string | null) => {
              if (!value) return null;
              const trimmed = value.trim();
              return trimmed.length > 0 ? trimmed : null;
            },
          })}
        />
      </div>

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

3. Muhim amaliy jihatlar

1. Input ichidagi vizual matn o'zgarmaydi

setValueAs faqatgina React Hook Form ichidagi holatga va handleSubmit dagi ma'lumotlar paketiga ta'sir qiladi.

  • Foydalanuvchi ko'rib turgan brauzer inputi ichidagi matn avtomatik ravishda o'zgarib qolmaydi.
  • Agar foydalanuvchi yozayotgan paytdayoq matnni formatlash (masalan, telefon maskasi yoki karta raqami oralig'iga probel qo'yish) zarur bo'lsa, setValue yoki Controller dan foydalanish to'g'ri bo'ladi.

2. Kiruvchi parametr tipi

setValueAs parametriga keladigan value har doim ham string bo'lmasligi mumkin. Masalan, formaning defaultValues holatidan dastlabki massiv yoki null kelishi mumkin. Shuning uchun kodda if (Array.isArray(value)) yoki if (!value) kabi xavfsiz tip tekshiruvlarini qo'shish tavsiya etiladi.