Dynamic Field Names — Dinamik field path'lar
Template literal field pathlar, Record va Map obyektlar, TypeScript Path<T> tiplashuvi, dinamik register, watch va setValue boshqaruvi.
76-dars
Dynamic Field Names — Dinamik field path'lar
Dynamic Field Names (dinamik maydon yo'llari) — bu inputlarning register(), watch(), setValue(), setError() va errors ichidagi yo'llari (field path) kodda oldindan qat'iy yozilmasdan, dastur ishlash jarayonida (runtime) o'zgaruvchi indekslar, til kodlari yoki ob'ekt kalitlari asosida dinamik shakllantirilishi jarayonidir.
Standart formalarda maydon nomlari statik bo'ladi (masalan, "email", "password"). Biroq murakkab tizimlarda yo'llar doim dinamik o'zgarib turadi:
- Massiv qatorlari:
items.${index}.priceyokiusers.${index}.contacts.${contactIndex}.phone - Ko'p tilli lokalizatsiya (i18n):
translations.${lang}.title,translations.${lang}.description - Dinamik konfiguratsiya va parametrlar (EAV/Dictionary):
settings.${moduleName}.${settingKey}
1. Dinamik Field Path ishlatiladigan asosiy ssenariylar
| Ssenariy | Dinamik Path tuzilmasi | Ma'lumotlar strukturasi |
|---|---|---|
| Massiv elementlari | `items.${index}.name` |
{ items: [{ name: "..." }] } |
| Lug'at / Map (Record) | `translations.${lang}.title` |
{ translations: { uz: { title: "..." } } } |
| Nested massivlar | `sections.${sIdx}.tasks.${tIdx}.title` |
{ sections: [{ tasks: [{ title: "" }] }] } |
| Dinamik atributlar | `attributes.${attrKey}` |
{ attributes: { color: "red", size: "XL" } } |
2. TypeScript bilan xavfsiz ishlash (Path<T> va as const)
JavaScript template literal shablonlaridan (`translations.${lang}.title`) foydalanganda, TypeScript uni shunchaki umumiy string deb tushunishi mumkin. React Hook Form esa qat'iy Path<T> tipini talab qiladi.
Buning uchun ikkita ishonchli yondashuv mavjud:
// 1-usul: "as const" orqali literal string sifatida ko'rsatish
register(`translations.${lang}.title` as const);
// 2-usul: React Hook Form'ning Path generic tipidan foydalanish
import { type Path } from "react-hook-form";
const titlePath: Path<FeatureConfigFormValues> = `translations.${targetLang}.title`;
setValue(titlePath, "Yangi matn");
3. Real misol: Ko'p tilli funksiyalar konfiguratsiyasi (i18n Dynamic Form)
Quyidagi misolda foydalanuvchi qaysi tillarni tanlashiga qarab (activeLangs) dinamik inputlar yaratiladi. Shuningdek, "O'zbek tilidan nusxalash" tugmasi dinamik watch() va setValue() orqali ma'lumotlarni o'tkazadi:
import React, { useState } from "react";
import { useForm, type Path, type SubmitHandler } from "react-hook-form";
// 1. Tiplar
type LangCode = "uz" | "en" | "ru";
type LocalizedContent = {
title: string;
description: string;
};
type FeatureConfigFormValues = {
featureKey: string;
translations: Record<LangCode, LocalizedContent>;
};
const ALL_LANGUAGES: { code: LangCode; label: string }[] = [
{ code: "uz", label: "O'zbekcha" },
{ code: "en", label: "English" },
{ code: "ru", label: "Русский" },
];
export function DynamicFieldPathsForm() {
// Faol tanlangan tillar
const [activeLangs, setActiveLangs] = useState<LangCode[]>(["uz", "en"]);
const {
register,
handleSubmit,
setValue,
watch,
reset,
formState: { errors, isSubmitting },
} = useForm<FeatureConfigFormValues>({
defaultValues: {
featureKey: "multi_language_module",
translations: {
uz: { title: "", description: "" },
en: { title: "", description: "" },
ru: { title: "", description: "" },
},
},
});
// Tilni yoqish / o'chirish
const toggleLang = (lang: LangCode) => {
setActiveLangs((prev) =>
prev.includes(lang) ? prev.filter((item) => item !== lang) : [...prev, lang]
);
};
// Dinamik yo'llar orqali UZ qiymatlarini tanlangan tilga nusxalash
const copyFromUz = (targetLang: LangCode) => {
const uzTitle = watch("translations.uz.title");
const uzDesc = watch("translations.uz.description");
const titlePath: Path<FeatureConfigFormValues> = `translations.${targetLang}.title`;
const descPath: Path<FeatureConfigFormValues> = `translations.${targetLang}.description`;
// Dinamik setValue chaqiruvi
setValue(titlePath, uzTitle, { shouldValidate: true, shouldDirty: true });
setValue(descPath, uzDesc, { shouldValidate: true, shouldDirty: true });
};
const onSubmit: SubmitHandler<FeatureConfigFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 300));
// Faqat aktiv holatda bo'lgan tillar bo'yicha yakuniy payload tuzish
const filteredTranslations = Object.fromEntries(
activeLangs.map((lang) => [lang, data.translations[lang]])
);
const payload = {
featureKey: data.featureKey,
translations: filteredTranslations,
};
console.log("Serverga yuborilayotgan tozalangan payload:", payload);
alert(`Konfiguratsiya saqlandi! Aktiv tillar: ${activeLangs.join(", ").toUpperCase()}`);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate style={{ maxWidth: "620px" }}>
{/* Asosiy maydon */}
<div style={{ marginBottom: "16px" }}>
<label htmlFor="featureKey" style={{ display: "block", fontWeight: 600, marginBottom: "4px" }}>
Feature kaliti *
</label>
<input
id="featureKey"
{...register("featureKey", { required: "Kalit nomi majburiy" })}
style={{ width: "100%", padding: "8px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.featureKey)}
/>
{errors.featureKey && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "4px" }}>
{errors.featureKey.message}
</p>
)}
</div>
{/* Tillarni faollashtirish paneli */}
<div style={{ marginBottom: "16px" }}>
<span style={{ display: "block", fontSize: "13px", fontWeight: 600, marginBottom: "6px" }}>
Faol tillarni tanlang:
</span>
<div style={{ display: "flex", gap: "8px", flexWrap: "wrap" }}>
{ALL_LANGUAGES.map((lang) => {
const isActive = activeLangs.includes(lang.code);
return (
<button
key={lang.code}
type="button"
onClick={() => toggleLang(lang.code)}
style={{
padding: "6px 12px",
background: isActive ? "#2563eb" : "#f1f5f9",
color: isActive ? "#fff" : "#475569",
border: "1px solid #cbd5e1",
borderRadius: "20px",
cursor: "pointer",
fontSize: "13px",
fontWeight: 500,
}}
>
{isActive ? "✓ " : "+ "}
{lang.label}
</button>
);
})}
</div>
</div>
{/* Dinamik tillar inputlari */}
<div style={{ display: "flex", flexDirection: "column", gap: "14px", marginBottom: "20px" }}>
{activeLangs.map((lang) => {
// Dinamik yo'llar
const titleField = `translations.${lang}.title` as const;
const descField = `translations.${lang}.description` as const;
const titleError = errors.translations?.[lang]?.title;
return (
<div
key={lang}
style={{
padding: "12px",
background: "#f8fafc",
borderRadius: "8px",
border: "1px solid #e2e8f0",
}}
>
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: "8px" }}>
<strong style={{ fontSize: "14px", color: "#1e293b" }}>
Til: {lang.toUpperCase()}
</strong>
{/* UZ dan nusxalash yordamchisi */}
{lang !== "uz" && activeLangs.includes("uz") && (
<button
type="button"
onClick={() => copyFromUz(lang)}
style={{
padding: "4px 8px",
background: "#e0f2fe",
color: "#0369a1",
border: "none",
borderRadius: "4px",
cursor: "pointer",
fontSize: "11px",
fontWeight: 600,
}}
>
UZ dan nusxalash
</button>
)}
</div>
{/* Dinamik sarlavha */}
<div style={{ marginBottom: "8px" }}>
<input
{...register(titleField, {
required: `${lang.toUpperCase()} tilidagi sarlavha kiritilishi shart`,
})}
placeholder={`Sarlavha (${lang.toUpperCase()})`}
style={{
width: "100%",
padding: "6px 10px",
boxSizing: "border-box",
borderColor: titleError ? "#e11d48" : "#cbd5e1",
borderWidth: "1px",
borderRadius: "4px",
}}
aria-invalid={Boolean(titleError)}
/>
{titleError && (
<p role="alert" style={{ color: "#e11d48", fontSize: "11px", margin: "2px 0 0 2px" }}>
{titleError.message}
</p>
)}
</div>
{/* Dinamik tavsif */}
<div>
<input
{...register(descField)}
placeholder={`Tavsif (${lang.toUpperCase()})`}
style={{
width: "100%",
padding: "6px 10px",
boxSizing: "border-box",
borderColor: "#cbd5e1",
borderWidth: "1px",
borderRadius: "4px",
}}
/>
</div>
</div>
);
})}
</div>
<div style={{ display: "flex", gap: "10px" }}>
<button
type="submit"
disabled={isSubmitting || activeLangs.length === 0}
style={{
padding: "10px 20px",
background: "#2563eb",
color: "#fff",
border: "none",
borderRadius: "6px",
cursor: isSubmitting || activeLangs.length === 0 ? "not-allowed" : "pointer",
fontWeight: 600,
}}
>
{isSubmitting ? "Saqlanmoqda..." : "Konfiguratsiyani saqlash"}
</button>
<button
type="button"
onClick={() => reset()}
style={{
padding: "10px 16px",
background: "#f1f5f9",
color: "#475569",
border: "1px solid #cbd5e1",
borderRadius: "6px",
cursor: "pointer",
}}
>
Qayta tiklash
</button>
</div>
</form>
);
}
4. Dinamik Field Path ishlatishda muhim qoidalar
- Nuqta sintaksisining to'g'riligi:
Ob'ekt va massivlar ichiga kirishda nuqta (
.) aniq qo'yilishi shart: masalan,translations.uz.titleyokiitems.0.price. - Yashirilgan / Noaktiv maydonlarni filtrlash:
Agar foydalanuvchi biror tilni UI'dan o'chirib tashlasa, uning ichidagi avval kiritilgan qiymat
useFormxotirasida qolishi mumkin. Shuning uchunonSubmitichida faqat hozirda aktiv bo'lgan kalitlarni filtrlab olish yokiunregister(path)chaqirish xavfsizlikni ta'minlaydi. setValue()da reaktivlikni saqlash: Dinamik yo'l orqali qiymat berayotganda validatsiya xatolari yo'qolishi va formaning o'zgarganligi qayd etilishi uchun{ shouldValidate: true, shouldDirty: true }opsiyalarini birga bering.