Series: React Hook Form Lesson 46

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");
    },
  })}
/>