useLocale

useLocale() は { locale, t } を返します。locale は app surface に実際に load された locale、t(key, values) は宣言済み app message を読み named value を補間します。不足した app key は shell translator へ fallback します。

TSX

import { useLocale } from '@sota/platform';

export function Greeting({ name }: { name: string }) {
  const { locale, t } = useLocale();
  return <p lang={locale}>{t('greeting', { name })}</p>;
}

YAML

locales:
  default: en
  files:
    en: src/locales/en.json
    ja: src/locales/ja.json

src/locales/en.json

JSON

{ "greeting": "Hello, {{name}}" }

src/locales/ja.json

JSON

{ "greeting": "こんにちは、{{name}}" }

選択 locale は app locale contract に従って fallback し、不足した app key は shell translator へ渡ります。両方にない重要 label には component fallback を用意します。