Локализация

Әр кірістірілген UI мәтіні (жабу түймелері, пагинация белгілері, сұрыптау хабарламалары, жүктеу сұраулары…) locale тізілімі арқылы шешіледі. Bundle-ге тек 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-ді ауыстырыңыз — пагинация белгілері мен dialog түймелері лезде жаңарады.

Locale таңдау

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

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

Теңшелетін locale тіркеу

addLocale хабарламаларыңызды ағылшын тілінің үстіне біріктіреді, сондықтан ішінара анықтамалар қауіпсіз. updateLocale бар 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" });

Өз компоненттеріңізде мәтіндерді оқу

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-ды fetch етіңіз).

Хабарлама анықтамасы

Толық кілттер жиыны ZephoraLocale типінде орналасқан — әрекеттер (close, cancel, confirm, clear…), деректер күйлері (loading, noData, emptyMessage), форма мәтіндері (showPassword, browseFiles, removeFile), навигация (pageOf, nextPage, breadcrumb), деректерді көрсету (sortAscending, selectAllRows, goToSlide) және күндер (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Толтырғыштар t(key, params) арқылы интерполяцияланатын {param} синтаксисін қолданады.