Series: React Hook Form Lesson 4

React Hook Form'ni o'rnatish — React + TypeScript + Vite loyihasiga ulash

React Hook Form paketini o'rnatish, Feature-based papkalar strukturasi, TypeScript tiplari va Vite muhitida birinchi amaliy formani yaratish.

4-dars

React Hook Form'ni o'rnatish — React + TypeScript + Vite loyihasiga ulash

React + TypeScript + Vite loyihasiga React Hook Form'ni ulash juda tez va sodda jarayon. Eng katta qulayliklardan biri — kutubxonaning o'zi TypeScript'da yozilgan bo'lib, barcha type definition'lar paket ichida tayyor holda keladi. Shu sababli alohida @types/react-hook-form o'rnatish talab etilmaydi.


1. Paketni o'rnatish

Loyiha ildiz papkasida o'zingiz foydalanayotgan paket menejeri orqali kutubxonani o'rnating:

# npm orqali
npm install react-hook-form

# pnpm orqali
pnpm add react-hook-form

# yarn orqali
yarn add react-hook-form

# bun orqali
bun add react-hook-form

2. Feature-based loyiha strukturasi

Zamonaviy va kengaytiriluvchi (scalable) frontend arxitekturasida formalarni ma'lum bir biznes funksiyasi bo'yicha guruhlash (Feature-based structure) tavsiya etiladi.

Masalan, autentifikatsiya (kirish va ro'yxatdan o'tish) formalarini quyidagicha tashkillashtirish qulay:

src/
├── features/
│   └── auth/
│       ├── components/
│       │   └── LoginForm.tsx
│       ├── types/
│       │   └── auth.types.ts
│       └── index.ts
├── routes/
│   └── login.tsx
└── App.tsx

Bunday tuzilish forma tiplari, komponentlari va validatsiya mantiqini bir joyda saqlashga hamda loyiha kattalashganda tartibni yo'qotmaslikka yordam beradi.


3. Real misol: Vite + React + TypeScript'da birinchi ishchi forma

Keling, login shakli misolida to'liq tiplashgan va xavfsiz birinchi formamizni quramiz.

1-qadam: Tiplarni aniqlash

src/features/auth/types/auth.types.ts faylida formamiz maydonlarining shaklini e'lon qilamiz:

export type LoginFormValues = {
  email: string;
  password: string;
};

2-qadam: Forma komponentini yaratish

src/features/auth/components/LoginForm.tsx faylida formani useForm hook'i bilan bog'laymiz:

import { useForm, type SubmitHandler } from "react-hook-form";
import type { LoginFormValues } from "../types/auth.types";

export function LoginForm() {
  const {
    register,
    handleSubmit,
    formState: { errors, isSubmitting },
  } = useForm<LoginFormValues>({
    defaultValues: {
      email: "",
      password: "",
    },
  });

  const onSubmit: SubmitHandler<LoginFormValues> = async (data) => {
    // Masalan, API client (Axios yoki Fetch) orqali backendga so'rov yuborish
    console.log("Yuboriladigan ma'lumotlar:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <div>
        <label htmlFor="email">Email</label>
        <input
          id="email"
          type="email"
          {...register("email", { required: "Email kiritish majburiy" })}
          placeholder="[email protected]"
        />
        {errors.email && <p style={{ color: "red" }}>{errors.email.message}</p>}
      </div>

      <div>
        <label htmlFor="password">Parol</label>
        <input
          id="password"
          type="password"
          {...register("password", { required: "Parol kiritish majburiy" })}
          placeholder="••••••••"
        />
        {errors.password && <p style={{ color: "red" }}>{errors.password.message}</p>}
      </div>

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

E'tibor berish kerak bo'lgan muhim jihatlar

  1. Generic tiplash (useForm<LoginFormValues>()):

    • Hook'ga generik tip berilganda, register("email") ichida xato maydon nomi yozilsa, TypeScript darhol xatolikni ko'rsatadi (masalan, register("emaill") xato deb topiladi).
    • onSubmit qabul qiluvchi data obyekti to'liq intellisense va avtomatik to'ldirishga (autocomplete) ega bo'ladi.
  2. defaultValues'ni ko'rsatish zarurati:

    • Formaning boshlang'ich qiymatlarini berish — yaxshi amaliyot (best practice).
    • Bu reset() funksiyasi chaqirilganda formani boshlang'ich holatga to'g'ri qaytaradi.
    • React'ning "uncontrolled component changed to controlled" kabi ogohlantirishlarini butunlay bartaraf etadi.
  3. SubmitHandler tipi:

    • React Hook Form kutubxonasi taqdim etuvchi SubmitHandler<T> tipi onSubmit funksiyasining asinxronligi va kiruvchi parametrlari xavfsizligini kafolatlaydi.