Series: React Hook Form Lesson 76

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}.price yoki users.${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

  1. Nuqta sintaksisining to'g'riligi: Ob'ekt va massivlar ichiga kirishda nuqta (.) aniq qo'yilishi shart: masalan, translations.uz.title yoki items.0.price.
  2. Yashirilgan / Noaktiv maydonlarni filtrlash: Agar foydalanuvchi biror tilni UI'dan o'chirib tashlasa, uning ichidagi avval kiritilgan qiymat useForm xotirasida qolishi mumkin. Shuning uchun onSubmit ichida faqat hozirda aktiv bo'lgan kalitlarni filtrlab olish yoki unregister(path) chaqirish xavfsizlikni ta'minlaydi.
  3. 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.