Lokalisasi

Setiap string UI bawaan (tombol tutup, label paginasi, pengumuman pengurutan, prompt unggah…) diselesaikan melalui registri locale. Hanya en yang tertanam di dalam bundel — setiap bahasa lain dimuat dari luar (modul yang dapat diimpor atau berkas JSON) dan didaftarkan dengan addLocale. Registri yang sama menggerakkan @zephora/react dan @zephora/native. en, tr.

Memuat sebuah 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

Demo langsung

Ganti locale — label paginasi dan tombol dialog diperbarui seketika.

Memilih locale

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

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

Mendaftarkan locale kustom

addLocale menggabungkan pesan Anda di atas bahasa Inggris, sehingga definisi parsial aman. updateLocale menambal locale yang sudah ada.

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

Membaca string di komponen Anda sendiri

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

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

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

Locale yang tersedia

Hadir dengan 48 terjemahan siap pakai. Masing-masing adalah modul independen — impor hanya yang Anda butuhkan (atau ambil .json yang sesuai).

Referensi pesan

Kumpulan kunci lengkap berada pada tipe ZephoraLocale — aksi (close, cancel, confirm, clear…), status data (loading, noData, emptyMessage), string formulir (showPassword, browseFiles, removeFile), navigasi (pageOf, nextPage, breadcrumb), tampilan data (sortAscending, selectAllRows, goToSlide), dan tanggal (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Placeholder menggunakan sintaks {param} yang diinterpolasi oleh t(key, params).