# General Translation React SDKs (gt-react, gt-next): loadDictionary
URL: https://generaltranslation.com/ja/docs/react/reference/functions/load-dictionary.mdx
---

title: loadDictionary
description: General Translation の gt-react をスタンドアロンの i18n ライブラリとして使用し、独自の辞書翻訳を読み込みます。loadDictionary の API リファレンス。

---

`loadDictionary` は、ロケール用の翻訳辞書を読み込むために自分で定義するローダー関数です。これは、`gt-react` をスタンドアロンの i18n ライブラリとして使用し、独自の翻訳を持ち込むためのものです。特に、既存の i18n プロジェクトを General Translation に移行する際に想定されています。

*`gt-react`、`gt-next`、`gt-tanstack-start`、`gt-react-native` に適用されますが、組み込み方法はそれぞれ異なります。`loadDictionary` はエクスポートされるシンボルではなく、自分で定義するローダーです。`gt-react` と `gt-tanstack-start` では、これを初期化呼び出し (下記) に渡します。`gt-next` では、`withGTConfig` プラグインを通じてこれを解決します (Next.js セクションで説明しています) 。このページで説明するローダーの契約は、どの環境でも共通です。*

## 概要 [#overview]

ロケールを受け取り、対応する辞書を返す関数を定義し、[`initializeGT`](/docs/react/reference/config#initialize) の `loadDictionary` オプションに渡します。シングルページアプリの場合は、代わりに [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) に渡します。

```tsx
const loadDictionary = (locale: string) =>
  import(`../public/locales/${locale}.json`).then((m) => m.default);

initializeGT({ ...gtConfig, loadDictionary });
```

*注: `gt-react` では、`loadDictionary` は [`<GTProvider>`](/docs/react/reference/components/gt-provider) の prop ではなく、初期化時に指定する設定オプションです。`loadDictionary` がサポートするのは、文字列翻訳を含む JSON ファイルのみです。*

## 仕組み [#how-it-works]

* **スタンドアロンの翻訳。** `loadDictionary` は、指定したロケールの翻訳 JSON ファイルを読み込みます。独自の翻訳を使用し、General Translation の翻訳インフラに依存しない場合に使います。
* **優先順位。** 複数の翻訳がある場合、`loadDictionary` で読み込んだ辞書は、[`loadTranslations`](/docs/react/reference/functions/load-translations) で読み込んだ翻訳より常に優先されます。
* **JSON のみ。** 文字列翻訳 を含む JSON ファイルのみをサポートします。

*2 つのローダーの違い: [`loadTranslations`](/docs/react/reference/functions/load-translations) は、CLI で管理される機械生成翻訳の取得方法 (CDN、データベース、または bundle から) をカスタマイズするためのものです。一方、`loadDictionary` は、独自の翻訳を使い、翻訳インフラなしで `gt-react` をスタンドアロンのライブラリとして実装するためのものです。*

## パラメータ [#parameters]

| パラメータ               | 説明           | 型        | 任意  | デフォルト |
| ------------------- | ------------ | -------- | --- | ----- |
| [`locale`](#locale) | 翻訳を読み込むロケール。 | `string` | いいえ | —     |

### `locale` [#locale]

**型** `string` · **必須**

辞書を読み込むロケールです。

## 戻り値 [#returns]

**型** `Promise<Dictionary>`

指定されたロケールについて、id と翻訳の対応を格納した `Dictionary` に解決される Promise。

## 例 [#examples]

```js title="loadDictionary.js"
export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}
```

## メモ [#notes]

* `loadDictionary` は、スタンドアロンで使用する独自の翻訳を読み込み、[`loadTranslations`](/docs/react/reference/functions/load-translations) よりも優先されます。
* サポートされるのは、文字列の翻訳を含む JSON ファイルのみです。
* 辞書エントリは、ランタイムで [`useTranslations`](/docs/react/reference/hooks/use-translations) を使って解決します。