التوطين

كل نص واجهة مدمج (أزرار الإغلاق، تسميات ترقيم الصفحات، إعلانات الفرز، مطالبات الرفع…) يُحَل عبر سجل اللغات. المدمج في الحزمة هو en فقط — وكل لغة أخرى تُحمَّل من الخارج (وحدة قابلة للاستيراد أو ملف JSON) وتُسجَّل بـ addLocale. ونفس السجل يشغّل @zephora/react و@zephora/native. en, tr.

تحميل لغة

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

عرض حي

بدّل اللغة — تتحدّث تسميات ترقيم الصفحات وأزرار الحوار فورًا.

اختيار لغة

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

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

تسجيل لغة مخصّصة

يدمج 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"

اللغات المتاحة

يأتي مع 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).