submitCount — Formani yuborish urinishlari sonini hisoblash va boshqarish
submitCount xususiyatining ishlashi, bir nechta muvaffaqiyatsiz urinishlardan keyin qo'shimcha yordam ko'rsatish, reset({ keepSubmitCount }) va analitika.
31-dars
submitCount — Submit urinishlari soni
submitCount — bu formState ichidagi maxsus sonli (number) xususiyat bo'lib, foydalanuvchi sahifada formani yuborishga (submit qilishga) necha marotaba uringanligini hisoblab boruvchi ichki hisoblagichdir (counter).
Forma dastlab yuklanganda uning qiymati 0 bo'ladi. Foydalanuvchi har safar submit tugmasini bosganida — validatsiyada xatolik bo'lishi yoki bo'lmasligidan qat'i nazar — submitCount qiymati bittaga oshadi (1, 2, 3...).
1. submitCount qanday ishlaydi?
- Ilk yuklanish: Komponent birinchi marta ekranga chiqqanda:
submitCount: 0. - Birinchi urinish: Foydalanuvchi forma maydonlarini bo'sh qoldirib tugmani bossa, validatsiya xatosi chiqadi, lekin
submitCount: 1ga ko'tariladi. - Ketma-ket bosish: Foydalanuvchi xatolikni tuzatmasdan yana 2 marta bossa, qiymat
submitCount: 3bo'ladi. reset()ta'siri: Agarreset()chaqirilsa, hisoblagich yana 0 ga tushadi (agar{ keepSubmitCount: true }opsiyasi berilmagan bo'lsa).
2. Qachon va nima uchun qo'llaniladi?
- Ketma-ket xatoliklarda qo'shimcha yordam taklif qilish: Masalan, foydalanuvchi login shaklini 3 marta noto'g'ri to'ldirsa, "Parolni unutdingizmi?" yoki "Qo'llab-quvvatlash xizmati bilan bog'laning" havolasini chiqarish.
- Dinamik captcha (reCAPTCHA) chiqarish: Foydalanuvchi bir nechta muvaffaqiyatsiz urinish qilgandagina robot emasligini tekshirish blokini faollashtirish.
- Analitika va UX monitoring: Foydalanuvchilar qaysi formani to'ldirishda eng ko'p qiyinchilikka duch kelayotganini aniqlash.
3. Real misol: Ko'p urinishdan so'ng qo'shimcha yordam ko'rsatish
Quyidagi kirish (login) shaklida foydalanuvchi 3 yoki undan ko'p marta xato bilan submit qilganda maxsus yordam ko'rsatishni ko'ramiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type LoginFormValues = {
email: string;
password: string;
};
export function SubmitCountForm() {
const {
register,
handleSubmit,
reset,
formState: { errors, submitCount, isSubmitting },
} = useForm<LoginFormValues>({
defaultValues: {
email: "",
password: "",
},
});
const onSubmit: SubmitHandler<LoginFormValues> = async (data) => {
// API so'rovi simulyatsiyasi (500ms)
await new Promise((resolve) => setTimeout(resolve, 500));
console.log("Muvaffaqiyatli kirildi:", data);
// Muvaffaqiyatli kirilgach hisoblagichni nollaymiz
reset();
};
const hasErrors = Object.keys(errors).length > 0;
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* Submit urinishlari soni */}
<p style={{ color: "#666", fontSize: "0.9rem" }}>
Submit urinishlari soni: <strong>{submitCount}</strong>
</p>
{/* 1. Email */}
<div>
<label htmlFor="loginEmail">Email</label>
<input
id="loginEmail"
type="email"
{...register("email", { required: "Email kiritish majburiy" })}
placeholder="[email protected]"
/>
{errors.email && <p style={{ color: "red" }}>{errors.email.message}</p>}
</div>
{/* 2. Parol */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="loginPassword">Parol</label>
<input
id="loginPassword"
type="password"
{...register("password", {
required: "Parol kiritilishi shart",
minLength: { value: 6, message: "Parol kamida 6 ta belgidan iborat bo'lsin" },
})}
placeholder="••••••••"
/>
{errors.password && <p style={{ color: "red" }}>{errors.password.message}</p>}
</div>
{/* 3 yoki undan ko'p marta urinish bo'lganda yordamchi xabar */}
{submitCount >= 3 && hasErrors && (
<div
style={{
marginTop: "1rem",
padding: "10px",
background: "#fff3e0",
border: "1px solid #ffe0b2",
color: "#e65100",
borderRadius: "4px",
}}
>
Bir necha bor urinildi. Agar parolni unutgan bo'lsangiz, iltimos,{" "}
<a href="/reset-password" style={{ color: "#d84315", fontWeight: "bold" }}>
parolni qayta tiklash
</a>{" "}
bo'limidan foydalaning.
</div>
)}
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.5rem" }}
>
{isSubmitting ? "Tekshirilmoqda..." : "Kirish"}
</button>
</form>
);
}
4. Muhim amaliy eslatmalar
-
isSubmittedvssubmitCount:isSubmittedfaqatgina forma kamida bir marta yuborildimi yoki yo'qmi deganbooleanqiymat beradi.submitCountesa aynan nechta urinish bo'lganini raqamlarda aniq ko'rsatib turadi. -
reset()chaqirilganda qiymatni saqlab qolish: Standartreset()chaqirilgandasubmitCountyana 0 ga tushadi. Agar hisoblagichni saqlab qolish kerak bo'lsa:reset(undefined, { keepSubmitCount: true });