بومی‌سازی

هر رشته متنی داخلی رابط کاربری (دکمه‌های بستن، برچسب‌های صفحه‌بندی، اعلان‌های مرتب‌سازی، پرامپت‌های آپلود…) از طریق رجیستری locale resolve می‌شود. فقط en در باندل جاسازی شده است — هر زبان دیگر از بیرون (ماژول قابل import یا فایل 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 یک مورد موجود را وصله می‌کند.

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 ترجمه آماده عرضه می‌شود. هر کدام یک ماژول مستقل است — فقط چیزی را که نیاز دارید import کنید (یا .json متناظر را fetch کنید).

مرجع پیام‌ها

مجموعه کامل کلیدها روی نوع ZephoraLocale قرار دارد — اکشن‌ها (close، cancel، confirm، clear…)، وضعیت‌های داده (loading، noData، emptyMessage)، رشته‌های فرم (showPassword، browseFiles، removeFile)، ناوبری (pageOf، nextPage، breadcrumb)، نمایش داده (sortAscending، selectAllRows، goToSlide) و تاریخ‌ها (prevMonth، chooseDate، firstDayOfWeek، intlLocale). Placeholder‌ها از سینتکس {param} استفاده می‌کنند که با t(key, params) درج می‌شود.