kuito.
Loslegen

localization

Namespace
Die Übersetzung dieser Seite fehlt oder ist veraltet, daher wird sie auf Englisch angezeigt. Auf Englisch lesen

Use localization for the user’s language order, calendars and clock preferences. Use message catalogs for UI strings and Intl for numbers and dates.

Read language and calendar preferences

tsx
import { watch, localization } from 'kuito';

const [locale] = localization.locales.value;
locale.languageTag; // 'pt-PT'
locale.currencyCode; // 'EUR'

const [calendar] = localization.calendars.value;
calendar.timeZone; // 'Europe/Lisbon'
calendar.uses24hourClock; // true

watch(localization.locales, ([preferred]) => console.log(preferred.languageTag)); // in a component

Translate a count with ICU messages

tsx
import { Text, localization } from 'kuito';

const t = localization.messages({
  en: {
    greeting: 'Hello, {name}!',
    inbox: '{count, plural, =0 {No messages} one {# message} other {# messages}}',
  },
  pt: {
    greeting: 'Olá, {name}!',
    inbox: '{count, plural, =0 {Sem mensagens} one {# mensagem} other {# mensagens}}',
  },
  'pt-PT': { greeting: 'Olá, {name}.' },
});

<Text>{t('inbox', { count: 3 })}</Text>; // '3 messages', or '3 mensagens' in Portuguese

Behavior and limits

locales and calendars are signals; reactive reads follow setting changes. messages(catalogs) chooses the best matching language and uses the first catalog as fallback for missing keys. Keep placeholders named and pass values separately. Layout direction follows the user language; use logical padding and margins so screens mirror correctly.

Continue

Read Localization rtl for the related workflow. The API reference lists every method, option, event and return type.

Referenz

Exporte 7

Methoden, Konstanten und Typen, die dieser native Namespace bereitstellt.

functionmessagesMessages in ICU MessageFormat, by key, in catalogs by language tag: the returned function formats a key in the catalog of the user's best language, which it reads at each call, so typeMessageCatalogsMessages by key, in catalogs by BCP 47 tag; the first catalog is the fallback.typeMessageValuesThe values a message's arguments take, by name.typeLocaleOne of the user's preferred languages, most preferred first.typeCalendarOne of the user's calendar settings, for showing dates, times and weeks the way the user reads them.valuelocalesThe user's languages, most preferred first; follows the system's settings while watched.valuecalendarsThe user's calendars, time zone and clock; follows the system's settings while watched.
Generiert aus den öffentlichen TypeScript-Deklarationen: Signaturen, Props und Standardwerte stammen aus der geprüften Quelle, Beschreibungen aus deren JSDoc. Kein Standardwert ist erfunden.