Lokalizacja

Każdy wbudowany tekst UI (przyciski zamykania, etykiety paginacji, komunikaty sortowania, monity przesyłania…) jest rozwiązywany przez rejestr locale. Tylko en jest osadzone w bundle — każdy inny język ładowany jest z zewnątrz (importowalny moduł lub plik JSON) i rejestrowany za pomocą addLocale. Ten sam rejestr napędza @zephora/react i @zephora/native. en, tr.

Ładowanie 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 na żywo

Zmień locale — etykiety paginacji i przyciski dialogu aktualizują się natychmiast.

Wybór locale

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

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

Rejestrowanie własnego locale

addLocale scala Twoje komunikaty na wierzchu angielskiego, więc częściowe definicje są bezpieczne. updateLocale łata istniejący.

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

Odczyt tekstów we własnych komponentach

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

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

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

Dostępne locale

Dostarczane z 48 gotowymi tłumaczeniami. Każde to niezależny moduł — importuj tylko to, czego potrzebujesz (lub pobierz pasujący .json).

Referencja komunikatów

Pełny zestaw kluczy znajduje się w typie ZephoraLocale — akcje (close, cancel, confirm, clear…), stany danych (loading, noData, emptyMessage), teksty formularzy (showPassword, browseFiles, removeFile), nawigacja (pageOf, nextPage, breadcrumb), prezentacja danych (sortAscending, selectAllRows, goToSlide) oraz daty (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Placeholdery używają składni {param} interpolowanej przez t(key, params).