Локалізація

Кожен вбудований рядок UI (кнопки закриття, мітки пагінації, оголошення сортування, підказки завантаження…) розв'язується через реєстр locale. У бандл вбудовано лише en — будь-яка інша мова завантажується ззовні (імпортований модуль або файл JSON) і реєструється через addLocale. Той самий реєстр обслуговує @zephora/react і @zephora/native. en, tr.

Завантаження 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

Живе демо

Перемкніть locale — мітки пагінації та кнопки діалогу оновляться миттєво.

Вибір locale

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

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

Реєстрація власного locale

addLocale накладає ваші повідомлення поверх англійських, тож часткові визначення безпечні. updateLocale патчить наявний.

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

Читання рядків у власних компонентах

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

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

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

Доступні locale

Постачається з 48 готовими перекладами. Кожен — незалежний модуль: імпортуйте тільки те, що потрібно (або завантажте відповідний .json).

Довідник повідомлень

Повний набір ключів міститься в типі ZephoraLocale — дії (close, cancel, confirm, clear…), стани даних (loading, noData, emptyMessage), рядки форм (showPassword, browseFiles, removeFile), навігація (pageOf, nextPage, breadcrumb), відображення даних (sortAscending, selectAllRows, goToSlide) та дати (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Плейсхолдери використовують синтаксис {param}, що інтерполюється функцією t(key, params).