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
-
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). onSubmitqabul qiluvchidataobyekti to'liq intellisense va avtomatik to'ldirishga (autocomplete) ega bo'ladi.
- Hook'ga generik tip berilganda,
-
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.
-
SubmitHandlertipi:- React Hook Form kutubxonasi taqdim etuvchi
SubmitHandler<T>tipionSubmitfunksiyasining asinxronligi va kiruvchi parametrlari xavfsizligini kafolatlaydi.
- React Hook Form kutubxonasi taqdim etuvchi