Lokalisierung

Jeder eingebaute UI-Text (Schließen-Buttons, Paginierungslabels, Sortieransagen, Upload-Aufforderungen…) wird über die Locale-Registry aufgelöst. Nur en ist im Bundle eingebettet — jede andere Sprache wird von außen geladen (importierbares Modul oder JSON-Datei) und mit addLocale registriert. Dieselbe Registry treibt @zephora/react und @zephora/native an. en, tr.

Ein Locale laden

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

Wechseln Sie das Locale — Paginierungslabels und Dialog-Buttons aktualisieren sich sofort.

Ein Locale auswählen

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

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

Ein eigenes Locale registrieren

addLocale führt Ihre Nachrichten über das Englische zusammen, sodass partielle Definitionen unbedenklich sind. updateLocale patcht ein bestehendes Locale.

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

Texte in eigenen Komponenten auslesen

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

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

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

Verfügbare Locales

Wird mit 48 fertigen Übersetzungen geliefert. Jede ist ein eigenständiges Modul — importieren Sie nur, was Sie benötigen (oder holen Sie die passende .json).

Nachrichtenreferenz

Der vollständige Schlüsselsatz liegt auf dem Typ ZephoraLocale — Aktionen (close, cancel, confirm, clear…), Datenzustände (loading, noData, emptyMessage), Formulartexte (showPassword, browseFiles, removeFile), Navigation (pageOf, nextPage, breadcrumb), Datenanzeige (sortAscending, selectAllRows, goToSlide) und Datumsangaben (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Platzhalter verwenden die {param}-Syntax, die von t(key, params) interpoliert wird.