Seriya: React Hook Form Dars 7

handleSubmit() — Form submit jarayonini to'liq boshqarish va xatolarni tutish

handleSubmit funksiyasining ishlashi: onValid va onInvalid callbacklari, isSubmitting asinxron boshqaruvi, setError bilan server xatolarini ko'rsatish va noValidate.

7-dars

handleSubmit() — Form submit jarayonini boshqarish

handleSubmit() — bu formani yuborish (submit) hodisasini to'liq o'z nazoratiga oladigan va validatsiya natijalariga qarab mos callback funksiyani ishga tushiradigan yuqori darajadagi wrapper funksiyadir.

Uning eng katta qulayliklaridan biri — <form onSubmit={...}> ichida har safar e.preventDefault() yozish shart emas; handleSubmit sahifa qayta yuklanishini avtomatik to'xtatadi va ma'lumotlarni tozalab beradi.


1. handleSubmit(onValid, onInvalid?) qanday ishlaydi?

handleSubmit ikkita argument qabul qiladi:

handleSubmit(onValid, onInvalid)
  1. Brauzer hodisasini to'xtatadi: e.preventDefault() ni avtomatik chaqiradi.
  2. Validatsiyani ishga tushiradi: Formadagi barcha ro'yxatdan o'tgan maydonlar va ulangan schema (Zod/Yup) qoidalarini bir vaqtning o'zida tekshiradi.
  3. Natijaga qarab ikkita yo'ldan birini tanlaydi:
    • Xatolik bo'lmasa — onValid(data, event): Forma to'liq to'g'ri to'ldirilgan bo'lsa, tozalangan va transformatsiya qilingan data obyekti bilan onValid funksiyasini chaqiradi. Agar onValid asinxron (async/await) bo'lsa, formState.isSubmitting avtomatik true ga o'tadi va API so'rov tugagach false bo'ladi.
    • Xatolik bo'lsa — onInvalid(errors, event): (Ixtiyoriy) Agar formadagi biror maydon validatsiyadan o'tmasa, barcha xatoliklar jamlangan errors obyektini qaytaradi. Bu analitika yozish, xabarnoma (toast) chiqarish yoki foydalanuvchini xatoli maydonga yo'naltirish uchun juda qulay.

2. Real misol: onValid, onInvalid va API so'rov

Quyidagi misolda yangi loyiha yaratish shakli, pattern orqali URL tekshirish va serverdan qaytgan xatolikni setError("root.serverError") orqali ko'rsatishni ko'rib chiqamiz:

import { useForm, type SubmitErrorHandler, type SubmitHandler } from "react-hook-form";

type CreateProjectForm = {
  title: string;
  repositoryUrl: string;
};

export function CreateProjectForm() {
  const {
    register,
    handleSubmit,
    setError,
    formState: { errors, isSubmitting },
  } = useForm<CreateProjectForm>({
    defaultValues: {
      title: "",
      repositoryUrl: "",
    },
  });

  // 1. Validatsiya muvaffaqiyatli o'tganda ishlaydi
  const onValid: SubmitHandler<CreateProjectForm> = async (data) => {
    try {
      // Masalan, backend API'ga ma'lumot yuborish
      const response = await fetch("/api/projects", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(data),
      });

      if (!response.ok) {
        throw new Error("Server xatosi");
      }

      console.log("Loyiha muvaffaqiyatli yaratildi:", data);
    } catch {
      // Backend xatosini alohida maydonga emas, balki butun formaning "root" xatosiga biriktiramiz
      setError("root.serverError", {
        type: "server",
        message: "Serverda xatolik yuz berdi. Iltimos, keyinroq qayta urinib ko'ring.",
      });
    }
  };

  // 2. Validatsiya xato berganda ishlaydi (ixtiyoriy)
  const onInvalid: SubmitErrorHandler<CreateProjectForm> = (formErrors) => {
    console.warn("Formada to'ldirilmagan yoki xato maydonlar bor:", formErrors);
  };

  return (
    <form onSubmit={handleSubmit(onValid, onInvalid)} noValidate>
      <div>
        <label htmlFor="title">Loyiha nomi</label>
        <input
          id="title"
          {...register("title", { required: "Loyiha nomi kiritilishi shart" })}
          placeholder="Portfolio platformasi"
        />
        {errors.title && <p style={{ color: "red" }}>{errors.title.message}</p>}
      </div>

      <div>
        <label htmlFor="repositoryUrl">Repository manzili</label>
        <input
          id="repositoryUrl"
          {...register("repositoryUrl", {
            required: "Repository havolasi majburiy",
            pattern: {
              value: /^https?:\/\/.+/,
              message: "Havola https:// bilan boshlanishi kerak",
            },
          })}
          placeholder="https://github.com/username/project"
        />
        {errors.repositoryUrl && (
          <p style={{ color: "red" }}>{errors.repositoryUrl.message}</p>
        )}
      </div>

      {/* Backend server xatoligi uchun umumiy ogohlantirish */}
      {errors.root?.serverError && (
        <div style={{ padding: "8px", background: "#ffebee", color: "#c62828" }}>
          {errors.root.serverError.message}
        </div>
      )}

      <button type="submit" disabled={isSubmitting}>
        {isSubmitting ? "Yuborilmoqda..." : "Yaratish"}
      </button>
    </form>
  );
}

3. Foydali amaliy tavsiyalar

1. noValidate atributi

Har doim formaga noValidate atributini qo'shing:

<form onSubmit={handleSubmit(onValid)} noValidate>

Bu brauzerning standart, tarjima qilib bo'lmaydigan va har bir operatsion tizimda har xil ko'rinadigan pop-up ogohlantirishlarini o'chiradi. Natijada xatolarni boshqarish to'liq sizning komponentlaringiz va RHF nazoratiga o'tadi.

2. Ikki marta bosishdan (Double Submit) himoyalanish

Foydalanuvchi tugmani ketma-ket bir necha marta bosib yuborishining oldini olish uchun:

  1. onValid funksiyasini async/await ko'rinishida yozing.
  2. Yuborish tugmasiga disabled={isSubmitting} prop'ini bering.
  3. handleSubmit birinchi asinxron so'rov tugamaguncha yangi submit jarayonini bloklaydi.

3. Server xatolarini setError("root") orqali ko'rsatish

Backenddan 400 yoki 500 status kodi kelganda, agar xatolik aniq bir inputga tegishli bo'lmasa, setError("root.serverError", { message: "..." }) dan foydalanish toza arxitekturani ta'minlaydi.