---
title: "useLocale"
description: "useLocale() は { locale, t } を返します。locale は app surface に実際に load された locale、t(key, values) は宣言済み app message を読み named value を補間します。不足した app key は shell translator へ fallback します。"
url: "https://sotaagents.ai/ja/manual/developer-guide/use-locale"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "ja"
---

# 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

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

`src/locales/en.json`

JSON

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

`src/locales/ja.json`

JSON

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

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