Lokalizacija

Vsak vgrajeni UI niz (gumbi za zapiranje, oznake paginacije, obvestila o razvrščanju, pozivi za nalaganje…) se razreši prek locale registryja. Samo en je vgrajen v bundle — vsak drug jezik se naloži od zunaj (uvozljiv modul ali JSON datoteka) in registrira z addLocale. Isti registry poganja @zephora/react in @zephora/native. en, tr.

Nalaganje locale-a

// 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

Live demo

Zamenjajte locale — oznake paginacije in gumbi dialoga se posodobijo takoj.

Izbira locale-a

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

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

Registracija prilagojenega locale-a

addLocale združi vaša sporočila prek angleščine, zato so delne definicije varne. updateLocale popravi obstoječega.

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" });

Branje nizov v lastnih komponentah

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

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

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

Razpoložljivi locale-i

Dobavljen z 48 že pripravljenimi prevodi. Vsak je neodvisen modul — uvozite samo tisto, kar potrebujete (ali pridobite ustrezni .json).

Referenca sporočil

Celoten nabor ključev živi na tipu ZephoraLocale — akcije (close, cancel, confirm, clear…), stanja podatkov (loading, noData, emptyMessage), nizi obrazcev (showPassword, browseFiles, removeFile), navigacija (pageOf, nextPage, breadcrumb), prikaz podatkov (sortAscending, selectAllRows, goToSlide) in datumi (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Ograde uporabljajo sintakso {param}, ki jo interpolira t(key, params).