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:
isDirtyyangilanmasdanfalseqolishi mumkin (natijada submit tugmasi bloklangan holda qoladi).- Validatsiya tekshirilmaydi, shuning uchun eski
errorsyo'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.