Lokalisointi

Jokainen sisäänrakennettu käyttöliittymäteksti (sulkupainikkeet, sivutusotsikot, lajittelun kuulutukset, latauskehotteet…) ratkaistaan locale-rekisterin kautta. Vain en on upotettu bundleen — jokainen muu kieli ladataan ulkopuolelta (tuotava moduuli tai JSON-tiedosto) ja rekisteröidään addLocale-funktiolla. Sama rekisteri ohjaa @zephora/react- ja @zephora/native-paketteja. en, tr.

Localen lataaminen

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

Vaihda localea — sivutusotsikot ja dialogipainikkeet päivittyvät välittömästi.

Localen valitseminen

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

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

Mukautetun localen rekisteröinti

addLocale sulauttaa viestisi englannin päälle, joten osittaiset määritelmät ovat turvallisia. updateLocale paikkaa olemassa olevan.

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

Tekstien lukeminen omissa komponenteissasi

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

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

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

Saatavilla olevat localet

Sisältää 48 valmista käännöstä. Jokainen on itsenäinen moduuli — tuo vain se, mitä tarvitset (tai hae vastaava .json).

Viestireferenssi

Koko avainjoukko elää ZephoraLocale-tyypissä — toiminnot (close, cancel, confirm, clear…), datan tilat (loading, noData, emptyMessage), lomaketekstit (showPassword, browseFiles, removeFile), navigointi (pageOf, nextPage, breadcrumb), datan esitys (sortAscending, selectAllRows, goToSlide) ja päivämäärät (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Paikkamerkit käyttävät {param}-syntaksia, jonka t(key, params) interpoloi.