touchedFields — Foydalanuvchi kirib chiqqan (blur bo'lgan) maydonlarni aniqlash
touchedFields obyektining ishlashi, blur hodisalari, dirtyFields bilan taqqoslanishi, xatolarni faqat maydonga tegilgandan so'ng ko'rsatish (UX).
32-dars
touchedFields — Foydalanuvchi interaction qilgan field'lar
touchedFields — bu formState ichidagi maxsus obyekt bo'lib, foydalanuvchi qaysi inputlarga fokus berib, so'ngra undan chiqib ketganligini (blur hodisasi yuz berganini) ko'rsatadi.
Ko'pincha dasturchilar dirtyFields va touchedFields ni adashtiradilar:
dirtyFields— maydondagi qiymatdefaultValuesdan o'zgargan-o'zgarmaganini tekshiradi.touchedFields— qiymat o'zgargan yoki o'zgarmaganidan qat'i nazar, foydalanuvchi o'sha input bilan o'zaro aloqa qilgani (tegib o'tgani) haqida ma'lumot beradi.
1. touchedFields qanday ishlaydi?
- Ilk yuklanish: Forma ochilganda barcha maydonlar uchun
touchedFields.fieldNameqiymatiundefined(ya'nifalse) bo'ladi. - Yozish paytida: Foydalanuvchi inputga bosib yozsa ham, hali maydondan tashqariga chiqmagan bo'lsa, u hali
touchedhisoblanmaydi. - Maydondan chiqilganda (
onBlur): Foydalanuvchi boshqa elementga o'tishi bilan RHFtouchedFields.fieldName = truedeb belgilaydi (hatto inputga birorta harf yozilmagan bo'lsa ham). reset()chaqirilganda:reset()ishga tushishi bilantouchedFieldsobyekti yana butunlay tozalanadi.
2. dirtyFields vs touchedFields taqqoslanishi
| Xususiyat | Nimani tekshiradi? | Qiymat o'zgarmasdan, shunchaki kirib chiqilsa (blur bo'lsa)? |
|---|---|---|
touchedFields |
Inputga fokus qilinib chiqib ketilganini (blur bo'lganini). |
true bo'ladi. |
dirtyFields |
Input qiymati defaultValues dan farqli ravishda o'zgarganini. |
undefined / false qoladi. |
3. Real misol: Xatolikni faqat foydalanuvchi maydondan chiqqanda ko'rsatish (Yaxshi UX)
Foydalanuvchi hali emailni yozib tugatmasdan turib unga darhol "Email noto'g'ri" deb qizil xabar chiqarish yomon foydalanuvchi tajribasidir. touchedFields yordamida xatolikni faqat foydalanuvchi maydondan chiqqandan keyingina ko'rsatish mumkin:
import { useForm, type SubmitHandler } from "react-hook-form";
type UserContactForm = {
fullName: string;
email: string;
};
export function TouchedFieldsForm() {
const {
register,
handleSubmit,
reset,
formState: { errors, touchedFields, isSubmitting },
} = useForm<UserContactForm>({
mode: "onBlur", // onBlur hodisasida validatsiyadan o'tkazish
defaultValues: {
fullName: "",
email: "",
},
});
const onSubmit: SubmitHandler<UserContactForm> = async (data) => {
console.log("Ma'lumotlar qabul qilindi:", data);
reset(); // touchedFields ham tozalanadi
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Ism maydoni */}
<div>
<label htmlFor="fullName">
To'liq ism{" "}
{touchedFields.fullName && (
<span style={{ fontSize: "0.8rem", color: "#666" }}>(tegilgan)</span>
)}
</label>
<input
id="fullName"
{...register("fullName", { required: "Ism kiritish majburiy" })}
placeholder="Ismingizni kiriting"
/>
{/* Faqat foydalanuvchi maydonga kirib chiqqanidan so'ng xatoni ko'rsatamiz */}
{touchedFields.fullName && errors.fullName && (
<p style={{ color: "red" }}>{errors.fullName.message}</p>
)}
</div>
{/* 2. Email maydoni */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="email">
Email manzil{" "}
{touchedFields.email && (
<span style={{ fontSize: "0.8rem", color: "#666" }}>(tegilgan)</span>
)}
</label>
<input
id="email"
type="email"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Haqiqiy email manzilini kiriting",
},
})}
placeholder="[email protected]"
/>
{touchedFields.email && errors.email && (
<p style={{ color: "red" }}>{errors.email.message}</p>
)}
</div>
<div style={{ marginTop: "1.5rem", display: "flex", gap: "10px" }}>
<button type="submit" disabled={isSubmitting}>
{isSubmitting ? "Yuborilmoqda..." : "Yuborish"}
</button>
<button type="button" onClick={() => reset()}>
Formani tozalash
</button>
</div>
</form>
);
}
4. Muhim amaliy eslatmalar
-
Proxy optimizatsiyasi:
touchedFieldsfoydalanuvchining har birblurharakatida yangilanadi. Agar komponentingizda bu holat kerak bo'lmasa, uniformStatedan ajratib olmang (destructure qilmang). Shunda komponent har safar inputdan chiqilganda behuda qayta render bo'lmaydi. -
mode: "onTouched"rejimi: Agar sizga har bir maydonda xatolik faqatgina birinchi marta inputdan chiqib ketilgandan keyin ko'rinishi, so'ngra yozish davomida real vaqtda tekshirib borilishi kerak bo'lsa,useForm({ mode: "onTouched" })sozlamasidan foydalanish eng optimal yechim hisoblanadi.