Seriya: React Hook Form Dars 43

setFocus() — Input maydoniga dasturiy fokus berish va matnni tanlash

setFocus() sintaksisi, shouldSelect opsiyasi, useRef o'rniga RHF orqali fokus berish va avtomatik xato fokusi mexanizmi.

43-dars

setFocus() — Kerakli input'ga focus berish

setFocus(name, options?) — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, formadagi ro'yxatdan o'tgan biror maydonni dasturiy yo'l bilan (programmatically) fokuslash (focus()) imkonini beradi.

Odatdagi React loyihalarida har bir input uchun alohida useRef yaratib, inputRef.current?.focus() deb yozish talab etiladi. React Hook Form esa bu jarayonni soddalashtiradi: shunchaki setFocus("fieldName") chaqirish orqali kursorni darhol kerakli inputga olib kelish mumkin.

U ko'pincha:

  • Modal yoki dialog oynasi ochilganda birinchi inputga darhol fokus berishda,
  • Tugma bosilganda qidiruv yoki promokod maydoniga o'tishda,
  • Muayyan server xatosi yoki foydalanuvchi harakatidan so'ng e'tiborni aniq maydonga qaratishda ishlatiladi.

1. setFocus() sintaksisi va konfiguratsiya opsiyalari

setFocus(name, options?)
Parametr / Opsiya Turi Tavsifi va vazifasi
name Path<T> Fokus berilishi kerak bo'lgan maydon nomi (masalan: "promoCode", "email" yoki ichki "profile.phone").
shouldSelect boolean true berilsa, maydon fokuslangandan so'ng uning ichidagi barcha matn ham avtomatik tarzda belgilanadi (select() qilinadi).

2. Real misol: Inputga fokus berish va matnni belgilash (shouldSelect)

Quyidagi misolda promokod inputiga oddiy fokus berish hamda foydalanuvchi eski kodni osongina almashtirishi uchun uni to'liq belgilab ochish (shouldSelect: true) ko'rsatilgan:

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

type PromoApplyFormValues = {
  promoCode: string;
};

export function SetFocusExampleForm() {
  const {
    register,
    setFocus,
    handleSubmit,
    formState: { errors },
  } = useForm<PromoApplyFormValues>({
    defaultValues: {
      promoCode: "WELCOME10",
    },
  });

  // 1. Shunchaki kursor olib borish (oddiy fokus)
  const handleFocusOnly = () => {
    setFocus("promoCode");
  };

  // 2. Fokus berish va input ichidagi matnni to'liq belgilab berish
  const handleFocusAndSelect = () => {
    setFocus("promoCode", { shouldSelect: true });
  };

  const onSubmit: SubmitHandler<PromoApplyFormValues> = (data) => {
    console.log("Qo'llangan promokod:", data.promoCode);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="promoCodeInput">Promokod</label>
        <input
          id="promoCodeInput"
          placeholder="Kodni kiriting"
          {...register("promoCode", {
            required: "Promokodni kiritish majburiy",
          })}
        />
        {errors.promoCode && (
          <p style={{ color: "red" }}>{errors.promoCode.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
        <button type="button" onClick={handleFocusOnly}>
          Inputga focus berish
        </button>

        <button type="button" onClick={handleFocusAndSelect}>
          Focus va matnni tanlash (select)
        </button>

        <button type="submit">
          Qo'llash
        </button>
      </div>
    </form>
  );
}

3. Muhim amaliy eslatmalar

1. Faqat register() qilingan va DOM'da mavjud maydonlar

setFocus() to'g'ri ishlashi uchun maydon register() orqali DOM elementiga biriktirilgan bo'lishi shart. Agar maydon shartli ravishda yashirilgan (unmount bo'lgan), disabled qilingan yoki ref o'rnatilmagan bo'lsa, fokus berib bo'lmaydi.

2. Validatsiya xatosida avtomatik fokus

handleSubmit funksiyasi validatsiyada xatolik yuz berganda, sukut bo'yicha (by default) eng birinchi xato chiqqan inputga avtomatik ravishda fokus beradi (shouldFocusError: true parametriga ko'ra). Shuning uchun submit paytida xatolarga fokus berish uchun qo'shimcha setFocus() yozish talab etilmaydi. setFocus() aynan dasturiy, maxsus UI ssenariylari uchun mo'ljallangan.