Localizzazione

Ogni stringa di interfaccia integrata (pulsanti di chiusura, etichette di paginazione, annunci di ordinamento, prompt di caricamento…) viene risolta tramite il registro delle locale. Solo en è incorporato nel bundle — tutte le altre lingue vengono caricate dall'esterno (modulo importabile o file JSON) e registrate con addLocale. Lo stesso registro alimenta @zephora/react e @zephora/native. en, tr.

Caricare una locale

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

Demo dal vivo

Cambia la locale — le etichette di paginazione e i pulsanti dei dialoghi si aggiornano all'istante.

Scegliere una locale

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

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

Registrare una locale personalizzata

addLocale unisce i tuoi messaggi sopra l'inglese, quindi le definizioni parziali sono sicure. updateLocale applica una patch a una locale esistente.

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

Leggere le stringhe nei tuoi componenti

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

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

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

Locale disponibili

Include 48 traduzioni pronte all'uso. Ciascuna è un modulo indipendente — importa solo ciò che ti serve (o recupera il .json corrispondente).

Riferimento dei messaggi

L'insieme completo delle chiavi vive nel tipo ZephoraLocale — azioni (close, cancel, confirm, clear…), stati dei dati (loading, noData, emptyMessage), stringhe di form (showPassword, browseFiles, removeFile), navigazione (pageOf, nextPage, breadcrumb), visualizzazione dati (sortAscending, selectAllRows, goToSlide) e date (prevMonth, chooseDate, firstDayOfWeek, intlLocale). I placeholder usano la sintassi {param} interpolata da t(key, params).