Localisation

Chaque chaîne d'interface intégrée (boutons de fermeture, libellés de pagination, annonces de tri, invites de téléversement…) est résolue via le registre de locales. Seul en est embarqué dans le bundle — toutes les autres langues sont chargées depuis l'extérieur (module importable ou fichier JSON) et enregistrées avec addLocale. Le même registre alimente @zephora/react et @zephora/native. en, tr.

Charger une 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

Démo en direct

Changez de locale — les libellés de pagination et les boutons de dialogue se mettent à jour instantanément.

Choisir une locale

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

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

Enregistrer une locale personnalisée

addLocale fusionne vos messages par-dessus l'anglais, donc les définitions partielles sont sûres. updateLocale corrige une locale existante.

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

Lire les chaînes dans vos propres composants

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

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

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

Locales disponibles

Livré avec 48 traductions prêtes à l'emploi. Chacune est un module indépendant — n'importez que ce dont vous avez besoin (ou récupérez le .json correspondant).

Référence des messages

L'ensemble complet des clés vit sur le type ZephoraLocale — actions (close, cancel, confirm, clear…), états de données (loading, noData, emptyMessage), chaînes de formulaire (showPassword, browseFiles, removeFile), navigation (pageOf, nextPage, breadcrumb), affichage de données (sortAscending, selectAllRows, goToSlide) et dates (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Les placeholders utilisent la syntaxe {param} interpolée par t(key, params).