Series: React Hook Form Lesson 31

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?

  1. Ilk yuklanish: Komponent birinchi marta ekranga chiqqanda: submitCount: 0.
  2. Birinchi urinish: Foydalanuvchi forma maydonlarini bo'sh qoldirib tugmani bossa, validatsiya xatosi chiqadi, lekin submitCount: 1 ga ko'tariladi.
  3. Ketma-ket bosish: Foydalanuvchi xatolikni tuzatmasdan yana 2 marta bossa, qiymat submitCount: 3 bo'ladi.
  4. reset() ta'siri: Agar reset() 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

  1. isSubmitted vs submitCount: isSubmitted faqatgina forma kamida bir marta yuborildimi yoki yo'qmi degan boolean qiymat beradi. submitCount esa aynan nechta urinish bo'lganini raqamlarda aniq ko'rsatib turadi.

  2. reset() chaqirilganda qiymatni saqlab qolish: Standart reset() chaqirilganda submitCount yana 0 ga tushadi. Agar hisoblagichni saqlab qolish kerak bo'lsa:

    reset(undefined, { keepSubmitCount: true });