isSubmitSuccessful — Formaning muvaffaqiyatli yuborilganini aniqlash
isSubmitSuccessful xususiyatining ishlashi, muvaffaqiyat xabarlarini ko'rsatish, reset({ keepIsSubmitSuccessful }) va server xatolarini boshqarish.
30-dars
isSubmitSuccessful — Submit muvaffaqiyatli yakunlanganini aniqlash
isSubmitSuccessful — bu formState ichidagi muhim boolean xususiyat bo'lib, formaning eng oxirgi yuborilish jarayoni hech qanday validatsiya to'siqlarisiz va onValid funksiyasi ichida kutilmagan xatoliklar (throw yoki rad etilgan Promise) yuz bermasdan to'liq va muvaffaqiyatli yakunlanganini bildiradi.
U asosan foydalanuvchiga "Muvaffaqiyatli saqlandi!" yoki "Xabaringiz qabul qilindi" kabi ijobiy xabarnomalarni (success alert/banner) chiqarishda qo'llaniladi.
1. isSubmitSuccessful qanday ishlaydi?
- Muvaffaqiyatli holat: Formadagi barcha qoidalar tekshiruvdan o'tib,
onSubmit(onValid) asinxron amali xatosiz tugasa,isSubmitSuccessful: truebo'ladi. - Xatolik yuz berganda:
- Agar biror maydonda validatsiya xatosi chiqsa;
- Yoki
onSubmitfunksiyasi ichida xatolik yuz bersa (masalan:throw new Error(...)yokiawaitqilingan API so'rovicatchqilinmasdan rad etilsa); isSubmitSuccessfuldarholfalsebo'ladi.
reset()bilan munosabati: Oddiyreset()chaqirilsa,isSubmitSuccessfulhamfalsega qaytadi. Agar formani tozalab, muvaffaqiyat xabarini ekranda saqlab qolmoqchi bo'lsangiz:reset(undefined, { keepIsSubmitSuccessful: true });
2. Real misol: Yangiliklarga obuna shakli va xatolarni boshqarish
Quyidagi misolda obuna shakli muvaffaqiyatli o'tganda xabar ko'rsatish, formani tozalash va server xatosini hisobga olishni ko'ramiz:
import { useState } from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
type NewsletterFormValues = {
email: string;
};
export function IsSubmitSuccessfulForm() {
const [serverError, setServerError] = useState<string | null>(null);
const {
register,
handleSubmit,
reset,
formState: { errors, isSubmitting, isSubmitSuccessful },
} = useForm<NewsletterFormValues>({
defaultValues: {
email: "",
},
});
const onSubmit: SubmitHandler<NewsletterFormValues> = async (data) => {
setServerError(null);
try {
// Backend API so'rovi simulyatsiyasi (500ms)
await new Promise((resolve) => setTimeout(resolve, 500));
console.log("Obuna muvaffaqiyatli rasmiylashtirildi:", data.email);
// Inputlarni tozalaymiz, lekin isSubmitSuccessful = true saqlanib qoladi:
reset(undefined, { keepIsSubmitSuccessful: true });
} catch {
setServerError("Server bilan bog'lanishda xatolik yuz berdi. Qayta urinib ko'ring.");
}
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="newsletterEmail">Email manzil</label>
<input
id="newsletterEmail"
type="email"
placeholder="[email protected]"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Iltimos, to'g'ri email manzilini kiriting",
},
})}
/>
{errors.email && (
<p style={{ color: "red" }}>{errors.email.message}</p>
)}
</div>
{/* Server xatosi yuz berganda */}
{serverError && (
<div style={{ padding: "8px", background: "#ffebee", color: "#c62828", marginTop: "1rem" }}>
{serverError}
</div>
)}
{/* Muvaffaqiyatli yuborilganda va server xatosi bo'lmaganda */}
{isSubmitSuccessful && !serverError && (
<div style={{ padding: "8px", background: "#e8f5e9", color: "#2e7d32", marginTop: "1rem" }}>
Tabriklaymiz! Siz yangiliklarga muvaffaqiyatli obuna bo'ldingiz.
</div>
)}
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.5rem" }}
>
{isSubmitting ? "Yuborilmoqda..." : "Obuna bo'lish"}
</button>
</form>
);
}
3. Muhim amaliy jihatlar
1. try/catch va server xatosi nozikligi
Agar siz API chaqiruvini try/catch ichiga olib, catch ichida xatolikni tashqi state'ga yozsangiz va throw qilmasangiz, JavaScript funksiyani "xatosiz yakunlandi" deb hisoblaydi va RHF isSubmitSuccessful: true qilib qo'yishi mumkin.
- Shuning uchun UI'da tekshiruvni
{isSubmitSuccessful && !serverError}ko'rinishida yozish; - Yoki RHF'ning o'zidagi
setError("root.serverError", { ... })funksiyasidan foydalanish tavsiya etiladi.
2. Keyingi urinishda yangilanish
Foydalanuvchi forma yuborilganidan so'ng yangi ma'lumot kiritib, yana submit tugmasini bossa, isSubmitSuccessful avtomatik tarzda o'sha yangi urinish natijasiga qarab qayta hisoblanadi.