defaultValues — Form uchun boshlang'ich qiymatlarni to'g'ri belgilash
defaultValues nima uchun muhim: reset() ishlashi, isDirty aniqligi, statik va asinxron (async API) defaultValues hamda isLoading holati.
8-dars
defaultValues — Form uchun boshlang'ich qiymatlarni belgilash
defaultValues — bu useForm() hook'iga uzatiladigan konfiguratsiya obyekti (yoki asinxron funksiya) bo'lib, formadagi barcha maydonlarning boshlang'ich qiymatlarini belgilaydi.
Ko'pchilik uni shunchaki inputlarga boshlang'ich matn qo'yish vositasi deb o'ylaydi, biroq React Hook Form (RHF) arxitekturasida defaultValues bir qancha muhim ichki mexanizmlar to'g'ri ishlashi uchun poydevor hisoblanadi.
1. defaultValues nima uchun muhim?
-
reset()funksiyasining to'g'ri ishlashi: Formadareset()chaqirilganda inputlar butunlay bo'shab qolmaydi, balki aynan sizdefaultValuesda belgilab qo'ygan boshlang'ich qiymatlarga qaytadi. -
isDirtyvadirtyFieldsaniqligi: Foydalanuvchi biror inputga yozsa, RHF joriy qiymatnidefaultValuesbilan taqqoslaydi va agar farq bo'lsaisDirty: trueqiladi. Agar foydalanuvchi kiritgan matnini o'chirib, yana boshlang'ich holatiga keltirsa,isDirtyavtomatik ravishda yanafalsega qaytadi. -
Controlled inputlar (
Controller) uchun kafolat:Controllerorqali ulangan tashqi komponentlardavalueboshidaundefinedbo'lib qolishining oldini oladi. Natijada React konsolida "uncontrolled component is changing to be controlled" ogohlantirishi chiqmaydi.
2. Real misollar: Statik va Asinxron defaultValues
1. Statik defaultValues (Yangi element yaratish formasi)
Yangi ma'lumot qo'shish shakllarida boshlang'ich qiymatlar statik tarzda beriladi:
import { useForm, type SubmitHandler } from "react-hook-form";
type TaskFormValues = {
title: string;
priority: "low" | "medium" | "high";
completed: boolean;
};
export function CreateTaskForm() {
const { register, handleSubmit, reset } = useForm<TaskFormValues>({
defaultValues: {
title: "",
priority: "medium",
completed: false,
},
});
const onSubmit: SubmitHandler<TaskFormValues> = (data) => {
console.log("Yangi vazifa saqlandi:", data);
// Formani tozalab, yana defaultValues holatiga qaytaramiz
reset();
};
return (
<form onSubmit={handleSubmit(onSubmit)}>
<div>
<input
{...register("title", { required: "Vazifa nomi majburiy" })}
placeholder="Vazifa nomi"
/>
</div>
<div>
<select {...register("priority")}>
<option value="low">Past</option>
<option value="medium">O'rta</option>
<option value="high">Yuqori</option>
</select>
</div>
<div>
<label>
<input type="checkbox" {...register("completed")} />
Bajarildi deb belgilash
</label>
</div>
<button type="submit">Qo'shish</button>
</form>
);
}
2. Asinxron defaultValues (Mavjud ma'lumotni tahrirlash formasi)
Tahrirlash (Edit) oynalarida ma'lumotlar serverdan API orqali biroz kechikib keladi. React Hook Form defaultValues ga to'g'ridan-to'g'ri async funksiya berishni qo'llab-quvvatlaydi.
Bunda RHF ma'lumot yuklanguncha formState.isLoading holatini o'zi boshqaradi:
import { useForm, type SubmitHandler } from "react-hook-form";
type EditUserForm = {
name: string;
email: string;
};
export function EditUserForm({ userId }: { userId: string }) {
const {
register,
handleSubmit,
formState: { isLoading, isDirty, isSubmitting },
} = useForm<EditUserForm>({
// Asinxron tarzda serverdan ma'lumot olib kelish:
defaultValues: async () => {
const response = await fetch(`/api/users/${userId}`);
if (!response.ok) {
throw new Error("Foydalanuvchi ma'lumotlarini yuklab bo'lmadi");
}
return await response.json();
},
});
const onSubmit: SubmitHandler<EditUserForm> = async (data) => {
await fetch(`/api/users/${userId}`, {
method: "PUT",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data),
});
console.log("Ma'lumot yangilandi:", data);
};
// Ma'lumot kelguncha yuklanish indikatorini ko'rsatamiz
if (isLoading) {
return <p>Ma'lumotlar yuklanmoqda...</p>;
}
return (
<form onSubmit={handleSubmit(onSubmit)}>
<div>
<label>Ism</label>
<input {...register("name")} placeholder="Ism" />
</div>
<div>
<label>Email</label>
<input {...register("email")} placeholder="Email" />
</div>
{/* Faqat foydalanuvchi ma'lumotni o'zgartirsagina tugma faollashadi */}
<button type="submit" disabled={!isDirty || isSubmitting}>
{isSubmitting ? "Saqlanmoqda..." : "Yangilash"}
</button>
</form>
);
}
3. Muhim tavsiyalar
-
Har bir maydon uchun boshlang'ich qiymat bering: Hech qachon biror maydonni
defaultValuesichida tushirib qoldirmang. Har doim boshlang'ich qiymat sifatida bo'sh satr"",0,falseyokinullbelgilang. Aks holdareset()vaisDirtykutilmagan natija berishi mumkin. -
TanStack Query (React Query) bilan ishlash: Agar ma'lumotlaringiz allaqachon TanStack Query keshida yuklangan bo'lsa:
datamavjud bo'lgandauseForm({ values: data })yokidefaultValues: dataqilib uzatish mumkin.valuesparametri har safar kesh yangilanganda forma qiymatlarini avtomatik sinxronlashtirib turadi.