Custom Input Components — Reusable input komponentlar yaratish
useController yordamida type-safe va reusable FormTextField yaratish, accessibility (aria-invalid, role=alert) va DRY tamoyili.
65-dars
Custom Input Components — Reusable input komponentlar yaratish
Custom Input Components — bu loyihadagi barcha formalarda bir xil stillar, yorliqlar (label), xatolik matnlari, fokus chegaralari hamda qulaylik atributlarini (accessibility — aria-invalid, role="alert") har safar qayta-qayta yozmaslik (DRY — Don't Repeat Yourself) uchun yaratiladigan qayta ishlatiluvchi universal komponentlardir.
React Hook Form bilan qayta ishlatiladigan inputlar yaratishning 2 ta asosiy yo'li mavjud:
register()+ forwardRef / ref prop: Oddiy HTML elementlar (<input>,<select>,<textarea>) uchun eng tezkor va yengil yondashuv;useController()hooki: Ichki validatsiya holatlarini (fieldState.error,fieldState.invalid) to'liq o'z ichida boshqaruvchi universal va type-safe yondashuv.
1. Reusable input komponent dizaynining 3 ta asosiy tamoyili
| Tamoyil | Qanday amalga oshiriladi? | Nima beradi? |
|---|---|---|
Type-safe name va control |
TypeScript generic'laridan foydalanish: <T extends FieldValues> bilan name: Path<T> va control: Control<T>. |
Forma ichida mavjud bo'lmagan maydon nomi yozilsa, TypeScript darhol xatolik ko'rsatadi (Autocompletion). |
| Markazlashtirilgan Accessibility | id, htmlFor, aria-invalid={fieldState.invalid} va role="alert" komponent ichida bir marta to'g'ri bog'lanadi. |
Ekranni o'quvchi qurilmalar (Screen Readers) xatolarni xatosiz taniydi va a11y standartlariga javob beradi. |
| Dizayn va mantiqni ajratish | Komponent faqat control, name, label, rules va vizual proplarni qabul qiladi. |
Asosiy forma kodi juda qisqa, toza va o'qish uchun sodda bo'lib qoladi. |
2. Real misol: useController() asosidagi universal FormTextField
Quyidagi misolda loyiha bo'ylab ixtiyoriy formada qayta ishlatish mumkin bo'lgan universal FormTextField komponenti yaratiladi va dasturchi profili formasida qo'llaniladi:
import {
useController,
useForm,
type Control,
type FieldValues,
type Path,
type RegisterOptions,
type SubmitHandler,
} from "react-hook-form";
// 1. Generic bilan to'liq type-safe qilingan Props
type FormTextFieldProps<T extends FieldValues> = {
name: Path<T>;
control: Control<T>;
label: string;
rules?: RegisterOptions<T, Path<T>>;
type?: "text" | "email" | "password" | "url" | "number";
placeholder?: string;
};
// 2. Qayta ishlatiluvchi universal maydon komponenti
function FormTextField<T extends FieldValues>({
name,
control,
label,
rules,
type = "text",
placeholder,
}: FormTextFieldProps<T>) {
const { field, fieldState } = useController({
name,
control,
rules,
});
const inputId = `field-${String(name)}`;
return (
<div style={{ marginBottom: "1.25rem" }}>
<label
htmlFor={inputId}
style={{ display: "block", fontWeight: 600, marginBottom: "4px" }}
>
{label}
</label>
<input
id={inputId}
type={type}
name={field.name}
value={field.value ?? ""}
onChange={field.onChange}
onBlur={field.onBlur}
ref={field.ref}
placeholder={placeholder}
aria-invalid={fieldState.invalid}
style={{
width: "100%",
maxWidth: "340px",
padding: "8px 12px",
borderRadius: "6px",
border: fieldState.invalid ? "2px solid #ef4444" : "1px solid #cbd5e1",
outline: "none",
}}
/>
{fieldState.error && (
<p style={{ color: "#ef4444", margin: "4px 0 0 0", fontSize: "0.85rem" }} role="alert">
{fieldState.error.message}
</p>
)}
</div>
);
}
// 3. Asosiy Forma
type DeveloperProfileFormValues = {
fullName: string;
email: string;
portfolioUrl: string;
};
export function CustomInputComponentsForm() {
const {
control,
handleSubmit,
reset,
formState: { isSubmitting },
} = useForm<DeveloperProfileFormValues>({
mode: "onBlur",
defaultValues: {
fullName: "",
email: "",
portfolioUrl: "",
},
});
const onSubmit: SubmitHandler<DeveloperProfileFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 300));
console.log("Saqlangan profil ma'lumotlari:", data);
reset();
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. To'liq ism maydoni */}
<FormTextField
name="fullName"
control={control}
label="To'liq ism"
placeholder="Masalan: Muhammadjon Meliqo'ziyev"
rules={{
required: "To'liq ism kiritilishi majburiy",
minLength: {
value: 3,
message: "Kamida 3 ta belgi kiriting",
},
}}
/>
{/* 2. Email maydoni */}
<FormTextField
name="email"
control={control}
type="email"
label="Ishchi email"
placeholder="[email protected]"
rules={{
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Email formati noto'g'ri",
},
}}
/>
{/* 3. Portfolio veb-sayti */}
<FormTextField
name="portfolioUrl"
control={control}
type="url"
label="Portfolio havolasi"
placeholder="https://dev-bro.uz"
rules={{
pattern: {
value: /^https?:\/\/.+/,
message: "Havola http:// yoki https:// bilan boshlanishi kerak",
},
}}
/>
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "0.5rem" }}
>
{isSubmitting ? "Saqlanmoqda..." : "Saqlash"}
</button>
</form>
);
}
3. Muhim amaliy tavsiyalar
1. Komponent propslarini haddan tashqari to'ldirmang
Ko'p uchraydigan xato: bitta universal inputga 30 xil styling, padding va margin propslarini qo'shish. Reusable input faqat formaga tegishli asosiy proplarni (name, control, label, rules, placeholder, type, disabled) olishi va tashqi sinflar uchun oddiygina className qabul qilishi yetarlidir.
2. Chuqur formalarda FormProvider integratsiyasi
Agar formangiz juda ko'p qatlamli bo'lsa, har bir <FormTextField> ga qo'lda control={control} deb yozish shart emas. Kelgusi darslarda ko'riladigan useFormContext() orqali control propini ixtiyoriy qilib, kontekstdan avtomatik olish mumkin.