Lokalizācija

Katrs iebūvētais UI teksts (aizvēršanas pogas, lapošanas etiķetes, kārtošanas paziņojumi, augšupielādes uzvednes…) tiek atrisināts caur locale reģistru. Komplektā ir iegults tikai en — katra cita valoda tiek ielādēta no ārpuses (importējams modulis vai JSON fails) un reģistrēta ar addLocale. Tas pats reģistrs virza @zephora/react un @zephora/native. en, tr.

Locale ielāde

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

Tiešraides demonstrācija

Pārslēdziet locale — lapošanas etiķetes un dialoga pogas atjaunojas uzreiz.

Locale izvēle

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

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

Pielāgota locale reģistrēšana

addLocale apvieno jūsu ziņojumus virs angļu valodas, tāpēc daļējas definīcijas ir drošas. updateLocale ielāpo esošo.

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

Tekstu lasīšana savās komponentēs

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

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

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

Pieejamie locale

Tiek piegādāts ar 48 gataviem tulkojumiem. Katrs ir neatkarīgs modulis — importējiet tikai to, kas jums nepieciešams (vai ielādējiet atbilstošo .json).

Ziņojumu atsauce

Pilns atslēgu komplekts atrodas ZephoraLocale tipā — darbības (close, cancel, confirm, clear…), datu stāvokļi (loading, noData, emptyMessage), formu teksti (showPassword, browseFiles, removeFile), navigācija (pageOf, nextPage, breadcrumb), datu attēlojums (sortAscending, selectAllRows, goToSlide) un datumi (prevMonth, chooseDate, firstDayOfWeek, intlLocale). Vietturi izmanto {param} sintaksi, ko interpolē t(key, params).