trigger() — Validatsiyani dasturiy va bosqichma-bosqich ishga tushirish
trigger() asinxron funksiyasi, chaqirish usullari, shouldFocus opsiyasi va ko'p bosqichli (multi-step) formalarda qadamma-qadam tekshirish amaliyoti.
46-dars
trigger() — Validation'ni qo'lda ishga tushirish
trigger(name?, options?) — bu useForm() (yoki useFormContext()) qaytaradigan asinxron funksiya (Promise<boolean>) bo'lib, formadagi barcha maydonlar yoki siz ko'rsatgan aniq maydon(lar) uchun validatsiyani dasturiy yo'l bilan (programmatically) ishga tushirish imkonini beradi.
U tekshirilayotgan barcha maydonlar validatsiyadan muvaffaqiyatli o'tsa true, aks holda kamida bitta xatolik aniqlansa false qiymatini qaytaradi hamda formState.errors obyektini yangilaydi.
U ko'pincha:
- Ko'p bosqichli (multi-step / wizard) formalarda keyingi qadamga o'tishdan oldin faqat joriy bosqich maydonlarini tekshirishda,
- O'zaro bog'liq maydonlarni qayta tekshirishda (masalan, asosiy parol o'zgarganda tasdiqlash parolini tekshirish),
- Formani to'liq submit qilmasdan turib alohida "Tekshirish" tugmasi bosilganda ishlatiladi.
1. trigger() ni chaqirish usullari
| Chaqirish usuli | Nimani tekshiradi? | Qachon ishlatiladi? |
|---|---|---|
await trigger() (argumentsiz) |
Formadagi barcha ro'yxatdan o'tgan maydonlarni to'liq tekshiradi. | Formani submit qilmasdan oldin barcha qoidalar to'g'riligiga ishonch hosil qilishda. |
await trigger("fieldName") |
Faqat ko'rsatilgan bitta aniq maydonni tekshiradi. | Muayyan inputni tekshirish yoki bog'liq maydonni qayta validatsiyadan o'tkazishda. |
await trigger(["a", "b"]) |
Faqat massivda ko'rsatilgan tanlangan maydonlarni tekshiradi. | Multi-step formaning joriy qadamidagi maydonlar guruhini tekshirishda. |
options konfiguratsiyasi:
shouldFocus: true— Agar tekshirilgan maydonlarning birortasida xatolik bo'lsa, avtomatik ravishda birinchi xato chiqqan input elementiga fokus (kursor) beradi.
2. Real misol: Ko'p bosqichli (Multi-step) formani qadamma-qadam tekshirish
Quyidagi misolda 1-bosqichdagi email va fullName to'g'ri kiritilmaguncha foydalanuvchi 2-bosqichga o'ta olmaydi. Bu jarayon trigger(["email", "fullName"], { shouldFocus: true }) orqali tekshiriladi:
import { useState } from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
type OnboardingFormValues = {
email: string;
fullName: string;
roleTitle: string;
};
export function TriggerValidationForm() {
const [step, setStep] = useState<1 | 2>(1);
const {
register,
trigger,
handleSubmit,
formState: { errors },
} = useForm<OnboardingFormValues>({
mode: "onSubmit",
defaultValues: {
email: "",
fullName: "",
roleTitle: "",
},
});
// 1-bosqich maydonlarini tekshirib, keyingi bosqichga o'tish
const handleNextStep = async () => {
const isStepOneValid = await trigger(["email", "fullName"], {
shouldFocus: true,
});
if (isStepOneValid) {
setStep(2);
}
};
const onSubmit: SubmitHandler<OnboardingFormValues> = (data) => {
console.log("Yakuniy ma'lumotlar:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{step === 1 && (
<div>
<h3>1-bosqich: Asosiy ma'lumotlar</h3>
<div>
<label htmlFor="trigEmail">Email</label>
<input
id="trigEmail"
type="email"
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "To'g'ri formatdagi email kiriting",
},
})}
/>
{errors.email && (
<p style={{ color: "red" }} role="alert">
{errors.email.message}
</p>
)}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="trigFullName">To'liq ism</label>
<input
id="trigFullName"
{...register("fullName", {
required: "To'liq ism kiritish majburiy",
minLength: {
value: 2,
message: "Kamida 2 ta belgi kiriting",
},
})}
/>
{errors.fullName && (
<p style={{ color: "red" }} role="alert">
{errors.fullName.message}
</p>
)}
</div>
<button
type="button"
onClick={handleNextStep}
style={{ marginTop: "1.25rem" }}
>
Keyingi bosqich
</button>
</div>
)}
{step === 2 && (
<div>
<h3>2-bosqich: Lavozim</h3>
<div>
<label htmlFor="trigRole">Lavozim</label>
<input
id="trigRole"
placeholder="Masalan: Frontend Engineer"
{...register("roleTitle", {
required: "Lavozimni ko'rsatish majburiy",
})}
/>
{errors.roleTitle && (
<p style={{ color: "red" }} role="alert">
{errors.roleTitle.message}
</p>
)}
</div>
<div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
<button type="button" onClick={() => setStep(1)}>
Ortga
</button>
<button type="submit">
Yakunlash
</button>
</div>
</div>
)}
</form>
);
}
3. Muhim amaliy eslatmalar
1. Har doim await bilan ishlating
trigger() asinxron (Promise<boolean>) funksiya hisoblanadi. Agar formangizda asinxron validatsiya qoidalari (masalan, serverdan email bandligini tekshiruvchi validate: async (val) => ...) bo'lsa, await trigger(...) natija to'liq qaytishini kutadi.
2. O'zaro bog'liq maydonlarni tekshirish (Dependent Fields)
Parol o'zgarganda tasdiq paroli (confirmPassword) ham qayta tekshirilishi lozim:
<input
type="password"
{...register("password", {
onChange: () => {
// Asosiy parol o'zgarganda confirmPassword maydonini ham qayta validatsiya qilamiz
trigger("confirmPassword");
},
})}
/>