delayError — Xatoliklarni ekranda ko'rsatishni kechiktirish (Debouncing)
useForm delayError sozlamasi, xatolar miltillashini (flicker) oldini olish, onChange rejimidagi UX optimizatsiyasi va submit xatti-harakati.
58-dars
delayError — Error ko'rsatishni kechiktirish
delayError — bu useForm({ delayError: ... }) konfiguratsiyasida belgilanadigan sonli (number, millisekundlarda) parametr bo'lib, validatsiya xatosi aniqlangandan so'ng errors obyektiga xato yozilishi va ekranda paydo bo'lishini ko'rsatilgan vaqtga kechiktiradi.
Agar kechikish vaqti tugamasdan oldin foydalanuvchi klaviaturada yozishni davom ettirib qiymatni to'g'rilasa, ichki taymer bekor qilinadi va xato xabari ekranda umuman ko'rinmasdan qoladi.
Bu sozlama ayniqsa mode: "onChange" ishlatilganda foydalanuvchi so'zlarni tez-tez yozayotgan paytda qizil xatoliklarning ekranda miltillab (flickering) paydo bo'lishi va yo'qolishining oldini olish uchun juda qulaydir.
1. delayError qanday ishlaydi?
| Holat | delayError bo'lmaganda (0 ms) |
delayError: 500 o'rnatilganda |
|---|---|---|
| Foydalanuvchi xato qiymat yozdi | Xato darhol errors obyektida paydo bo'ladi va ekranda ko'rinadi. |
500 ms kutadi; agar xato o'sha holatda qolsa, 500 ms o'tgach errors ga yoziladi. |
| 500 ms ichida qiymat to'g'rilandi | Xato bir soniyaga ko'rinib, so'ng darhol o'chadi (yoqimsiz miltillash). | Taymer bekor qilinadi — foydalanuvchi xato xabarini umuman ko'rmaydi. |
| Forma yuborilganda (Submit) | Xatolar darhol ko'rsatiladi. | Submit paytida xatolar kechiktirilmasdan zudlik bilan tekshiriladi va ko'rsatiladi. |
2. Real misol: mode: "onChange" va delayError: 500 kombinatsiyasi
Quyidagi misolda foydalanuvchi har bir harf kiritganda tekshiruv ishlaydi, biroq xatolik xabari faqat foydalanuvchi to'xtaganidan keyin 500 ms o'tgach paydo bo'ladi:
import { useForm, type SubmitHandler } from "react-hook-form";
type DelayedErrorFormValues = {
username: string;
email: string;
};
export function DelayErrorForm() {
const {
register,
handleSubmit,
formState: { errors, isSubmitting },
} = useForm<DelayedErrorFormValues>({
mode: "onChange",
delayError: 500, // Xato ko'rsatishni 500 ms kechiktiradi (Debounce)
defaultValues: {
username: "",
email: "",
},
});
const onSubmit: SubmitHandler<DelayedErrorFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 300));
console.log("Muvaffaqiyatli yuborildi:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Username maydoni */}
<div>
<label htmlFor="deUsername">Username (500 ms kechikish bilan)</label>
<input
id="deUsername"
placeholder="Kamida 4 ta belgi"
{...register("username", {
required: "Username kiritish majburiy",
minLength: {
value: 4,
message: "Username kamida 4 ta belgidan iborat bo'lsin",
},
})}
/>
{errors.username && (
<p style={{ color: "red" }} role="alert">
{errors.username.message}
</p>
)}
</div>
{/* 2. Email maydoni */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="deEmail">Email manzili</label>
<input
id="deEmail"
type="email"
placeholder="[email protected]"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Email formati noto'g'ri",
},
})}
/>
{errors.email && (
<p style={{ color: "red" }} role="alert">
{errors.email.message}
</p>
)}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.25rem" }}
>
Saqlash
</button>
</form>
);
}
3. Muhim amaliy tavsiyalar
1. Optimal vaqt oralig'i: 300–600 ms
Kechikish vaqtini juda katta (masalan: 1500–3000 ms) qo'ymang. Haddan tashqari katta kechikish foydalanuvchida interfeys qotib qolgan yoki tekshirmayotgandek salbiy taassurot uyg'otadi. Inson idroki uchun eng qulay vaqt oralig'i 300 ms dan 500 ms gacha hisoblanadi.
2. mode: "onChange" va mode: "all" uchun mo'ljallangan
Agar sizda mode: "onBlur" bo'lsa, foydalanuvchi baribir inputdan chiqib ketganidan keyin xato chiqadi, shu sababli delayError ning u yerda unchalik zarurati yo'q. U aynan har bir harf kiritilganda tekshiriluvchi onChange rejimida foydalanuvchiga asabiy ta'sir qilmaslik uchun kiritilgan.