Τοπικοποίηση

Κάθε ενσωματωμένο κείμενο UI (κουμπιά κλεισίματος, ετικέτες σελιδοποίησης, ανακοινώσεις ταξινόμησης, προτροπές μεταφόρτωσης…) επιλύεται μέσω του μητρώου locale. Μόνο το en είναι ενσωματωμένο στο bundle — κάθε άλλη γλώσσα φορτώνεται από έξω (εισαγόμενο module ή αρχείο 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

Ζωντανό demo

Άλλαξε το 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" });

Ανάγνωση κειμένων στα δικά σου components

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

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

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

Διαθέσιμα locales

Έρχεται με 48 έτοιμες μεταφράσεις. Η καθεμία είναι ανεξάρτητο module — εισήγαγε μόνο ό,τι χρειάζεσαι (ή κάνε fetch το αντίστοιχο .json).

Αναφορά μηνυμάτων

Το πλήρες σύνολο κλειδιών βρίσκεται στον τύπο ZephoraLocale — ενέργειες (close, cancel, confirm, clear…), καταστάσεις δεδομένων (loading, noData, emptyMessage), κείμενα φόρμας (showPassword, browseFiles, removeFile), πλοήγηση (pageOf, nextPage, breadcrumb), εμφάνιση δεδομένων (sortAscending, selectAllRows, goToSlide) και ημερομηνίες (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Οι placeholders χρησιμοποιούν τη σύνταξη {param} που παρεμβάλλεται από το t(key, params).