การแปลภาษา

ข้อความ UI ในตัวทุกชิ้น (ปุ่มปิด, ป้ายเพจจิเนชัน, การประกาศการเรียงลำดับ, ข้อความอัปโหลด…) จะถูกแปลงผ่าน locale registry มีเพียง en เท่านั้นที่ฝังอยู่ในบันเดิล — ภาษาอื่นทุกภาษาจะถูกโหลดจากภายนอก (โมดูลที่ import ได้หรือไฟล์ JSON) แล้วลงทะเบียนด้วย addLocale registry เดียวกันนี้ขับเคลื่อนทั้ง @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 ภาษา แต่ละภาษาเป็นโมดูลอิสระ — import เฉพาะที่คุณต้องการ (หรือ fetch ไฟล์ .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)