Lokalizáció

Minden beépített UI-szöveg (bezárás gombok, lapozási címkék, rendezési bejelentések, feltöltési kérdések…) a locale-regisztráción keresztül oldódik fel. Csak az en van beágyazva a bundle-be — minden más nyelv kívülről töltődik be (importálható modul vagy JSON fájl), és az addLocale-lel regisztrálódik. Ugyanaz a regisztráció hajtja a @zephora/react-et és a @zephora/native-et. en, tr.

Egy locale betöltése

// 1) As a module (tree-shaken, typed):
import { addLocale } from "@zephora/react";
import { trLocale } from "@zephora/theme/locales/tr";
addLocale("tr", trLocale);

// 2) As JSON over the network (e.g. from your CDN):
const messages = await fetch("/locales/tr.json").then((r) => r.json());
addLocale("tr", messages);
// JSON dosyası pakette hazır: @zephora/theme/locales/tr.json

Élő demó

Válts locale-t — a lapozási címkék és a dialógus gombok azonnal frissülnek.

Locale kiválasztása

// Web
<ZephoraConfigProvider locale="tr">...</ZephoraConfigProvider>

// React Native
<ZephoraProvider theme={lightTheme} locale="tr">...</ZephoraProvider>

Egyéni locale regisztrálása

Az addLocale az üzeneteidet az angol fölé egyesíti, így a részleges definíciók biztonságosak. Az updateLocale egy meglévőt foltoz.

import { addLocale, updateLocale } from "@zephora/react";

addLocale("de", {
  intlLocale: "de",
  firstDayOfWeek: 1,
  close: "Schließen",
  cancel: "Abbrechen",
  confirm: "Bestätigen",
  loading: "Wird geladen…",
  pageOf: "Seite {page} von {count}",
});

updateLocale("de", { clear: "Leeren" });

Szövegek olvasása a saját komponenseidben

import { useLocale, localeOption } from "@zephora/react";

function SaveBar() {
  const { t } = useLocale();
  return <Button>{t("apply")}</Button>;
}

// Outside React:
localeOption("cancel", "tr"); // "İptal"

Elérhető locale-ok

48 kész fordítással érkezik. Mindegyik önálló modul — csak azt importáld, amire szükséged van (vagy töltsd le a megfelelő .json-t).

Üzenet-referencia

A teljes kulcskészlet a ZephoraLocale típuson él — műveletek (close, cancel, confirm, clear…), adatállapotok (loading, noData, emptyMessage), űrlapszövegek (showPassword, browseFiles, removeFile), navigáció (pageOf, nextPage, breadcrumb), adatmegjelenítés (sortAscending, selectAllRows, goToSlide) és dátumok (prevMonth, chooseDate, firstDayOfWeek, intlLocale). A helykitöltők a {param} szintaxist használják, amelyet a t(key, params) interpolál.