formState — Forma holatini to'liq boshqarish va Proxy optimizatsiyasi
formState xususiyatlari: errors, isSubmitting, isDirty, isValid, dirtyFields, touchedFields, Proxy obunasi va reset imkoniyatlari.
24-dars
formState — Form holatini boshqarish
formState — bu useForm() (yoki useFormContext()) qaytaradigan maxsus reaktiv obyekt bo'lib, formaning joriy holati haqidagi barcha muhim ma'lumotlarni beradi: validatsiya xatolari, serverga so'rov ketish jarayoni, foydalanuvchi qaysi maydonlarni o'zgartirgani (isDirty), qaysi biriga kirib chiqqani (touchedFields) va formaning umumiy to'g'riligi (isValid).
1. Eng ko'p ishlatiladigan formState xususiyatlari
| Xususiyat | Tipi | Ma'nosi va Vazifasi |
|---|---|---|
errors |
FieldErrors<T> |
Validatsiyadan o'tmagan maydonlar xatolari (message, type, ref). |
isSubmitting |
boolean |
handleSubmit ichidagi asinxron so'rov davom etayotganda true bo'ladi. Tugmani bloklash (disable) va yuklanish indikatorini chiqarish uchun qulay. |
isSubmitted |
boolean |
Forma kamida bir marta yuborishga urinilgan bo'lsa true bo'ladi (reset() chaqirilguncha). |
isSubmitSuccessful |
boolean |
Oxirgi submit operatsiyasi xatolarsiz muvaffaqiyatli yakunlangan bo'lsa true bo'ladi. |
isDirty |
boolean |
Kamida bitta maydon qiymati defaultValues dan farqli ravishda o'zgartirilgan bo'lsa true. |
dirtyFields |
Partial<Record<keyof T, boolean>> |
Anan qaysi maydonlar o'zgartirilganini ko'rsatuvchi xarita. |
touchedFields |
Partial<Record<keyof T, boolean>> |
Foydalanuvchi qaysi inputlarga kirib chiqqanini (blur bo'lganini) ko'rsatadi. |
isValid |
boolean |
Formada hech qanday validatsiya xatosi bo'lmasa true bo'ladi. |
isLoading |
boolean |
defaultValues asinxron funksiya sifatida berilganda, u serverdan yuklanguncha true bo'ladi. |
2. Real misol: isDirty, isSubmitting, isSubmitSuccessful va errors
Sozlamalar formasida ma'lumot faqat o'zgargandagina saqlash tugmasini yoqish, so'rov paytida tugmani bloklash va muvaffaqiyat xabarini ko'rsatishni amalga oshiramiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type SettingsFormValues = {
workspaceName: string;
contactEmail: string;
};
export function FormStateExample() {
const {
register,
handleSubmit,
reset,
formState: {
errors,
isDirty,
isSubmitting,
isSubmitSuccessful,
},
} = useForm<SettingsFormValues>({
defaultValues: {
workspaceName: "MuSa Falah",
contactEmail: "[email protected]",
},
});
const onSubmit: SubmitHandler<SettingsFormValues> = async (data) => {
// API so'rov simulyatsiyasi (600ms)
await new Promise((resolve) => setTimeout(resolve, 600));
console.log("Muvaffaqiyatli saqlandi:", data);
// Saqlangan qiymatlarni yangi defaultValues sifatida mustahkamlaymiz:
// Natijada isDirty yana false holatiga qaytadi
reset(data, { keepIsSubmitSuccessful: true });
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Ish maydoni nomi */}
<div>
<label htmlFor="workspaceName">Ish maydoni nomi</label>
<input
id="workspaceName"
{...register("workspaceName", { required: "Ish maydoni nomi majburiy" })}
/>
{errors.workspaceName && (
<p style={{ color: "red" }}>{errors.workspaceName.message}</p>
)}
</div>
{/* 2. Aloqa emaili */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="contactEmail">Aloqa emaili</label>
<input
id="contactEmail"
type="email"
{...register("contactEmail", {
required: "Email kiritilishi shart",
})}
/>
{errors.contactEmail && (
<p style={{ color: "red" }}>{errors.contactEmail.message}</p>
)}
</div>
{/* Muvaffaqiyatli saqlanganda xabarnoma */}
{isSubmitSuccessful && !isDirty && (
<div style={{ padding: "8px", background: "#e8f5e9", color: "#2e7d32", marginTop: "1rem" }}>
O'zgarishlar muvaffaqiyatli saqlandi!
</div>
)}
{/* Faqat o'zgarish kiritilgan bo'lsa va so'rov ketmayotgan bo'lsa faol bo'ladi */}
<button
type="submit"
disabled={!isDirty || isSubmitting}
style={{ marginTop: "1.5rem" }}
>
{isSubmitting ? "Saqlanmoqda..." : "Saqlash"}
</button>
</form>
);
}
3. Muhim arxitekturaviy jihatlar
1. Faqat kerakli xususiyatlarni destructuring qiling
formState ichki arxitekturada JavaScript Proxy mexanizmi orqali ishlaydi.
- RHF faqatgina siz komponentda o'qigan (
destructureqilgan) xususiyatlarni kuzatadi. - Masalan, agar siz faqat
errorsvaisSubmittingni ajratib olgan bo'lsangiz, foydalanuvchi yozgandaisDirtyyokidirtyFieldso'zgarsa ham komponentingiz ortiqcha qayta render qilinmaydi.
2. isValid va mode sozlamasi
- Agar formangizda
mode: "onSubmit"(standart holat) bo'lsa,isValiddastlabki render paytida noto'g'ri (ko'pinchafalse) ko'rinishi yoki forma birinchi marta submit qilinmaguncha o'zgarmasligi mumkin. - Agar sizga real vaqtda har bir klavish bosilganda to'g'ri ishlovchi
isValid(masalan, formani to'g'ri to'ldirmaguncha tugmani nofaol qilib turish) kerak bo'lsa,mode: "onChange"yokimode: "onBlur"sozlamasidan foydalaning.