Lokalizacija

Kiekvienas įtaisytas UI tekstas (uždarymo mygtukai, puslapiavimo etiketės, rūšiavimo pranešimai, įkėlimo raginimai…) išsprendžiamas per locale registrą. Į paketą įterpta tik en — kiekviena kita kalba įkeliama iš išorės (importuojamas modulis arba JSON failas) ir registruojama su addLocale. Tas pats registras valdo @zephora/react ir @zephora/native. en, tr.

Locale įkėlimas

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

Tiesioginė demonstracija

Perjunkite locale — puslapiavimo etiketės ir dialogo mygtukai atsinaujina akimirksniu.

Locale pasirinkimas

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

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

Pasirinktinio locale registravimas

addLocale sulieja jūsų pranešimus virš anglų kalbos, todėl daliniai apibrėžimai yra saugūs. updateLocale pataiso esamą.

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

Tekstų skaitymas savo komponentuose

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

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

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

Prieinami locale

Pristatoma su 48 paruoštais vertimais. Kiekvienas yra nepriklausomas modulis — importuokite tik tai, ko reikia (arba atsisiųskite (fetch) atitinkamą .json).

Pranešimų žinynas

Visas raktų rinkinys yra ZephoraLocale tipe — veiksmai (close, cancel, confirm, clear…), duomenų būsenos (loading, noData, emptyMessage), formų tekstai (showPassword, browseFiles, removeFile), navigacija (pageOf, nextPage, breadcrumb), duomenų rodymas (sortAscending, selectAllRows, goToSlide) ir datos (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Vietaženkliai naudoja {param} sintaksę, interpoliuojamą su t(key, params).