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 tarzdanullga o'tkazish.
1. Qanday ishlaydi?
- Foydalanuvchi yozadi yoki o'zgartiradi: Input hodisasi yuz berishi bilan RHF
setValueAs(value)funksiyasini chaqiradi. - Transformatsiya qilingan qiymat ichki xotiraga yoziladi: Yangilangan qiymat RHF ichki holatida saqlanadi.
- Validatsiya va Submit shu qiymat bilan ishlaydi: Keyingi barcha tekshiruvlar (
validate,required) vahandleSubmitdagi yakuniydataobyekti 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,
setValueyokiControllerdan 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.