# gt-react: General Translation React SDK: loadDictionary
URL: https://generaltranslation.com/ja/docs/react/api/config/load-dictionary.mdx
---
title: loadDictionary
description: loadDictionary() 関数のAPIリファレンス
---

{/* 自動生成: 直接編集せず、代わりに content/docs-templates/ 内のテンプレートを編集してください。 */}


## 概要

`loadDictionary` は、指定したロケールの翻訳 JSON ファイルを読み込みます。

この関数は、`gt-react` をスタンドアロンの i18n ライブラリとして使いたい場合を想定しています。

この関数は主に、既存の翻訳を維持したまま、i18n を導入済みの既存プロジェクトを General Translation に移行する際に使用されます。

複数の翻訳が存在する場合、`loadDictionary` で読み込んだ辞書の翻訳が常に他の翻訳より優先されます。
`loadDictionary` で使用できるのは、文字列の翻訳を含む JSON ファイルのみです。

## リファレンス

### パラメータ

<TypeTable
  type={{
  "locale": {
      type: 'string',
      optional: false,
  },
}}
/>

### 説明

| 型        | 説明           |
| -------- | ------------ |
| `locale` | 翻訳を読み込むロケール。 |

### 戻り値

指定されたロケールの、ID から翻訳へのマッピングを格納した辞書に解決される `Promise<any>`。

***

## セットアップ

通常、辞書は `./public/locales` ディレクトリから読み込みます。

`loadDictionary` をファイル内で定義します。
この関数は、指定されたロケールの翻訳を含むオブジェクトに解決される Promise を返すようにしてください。

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

次に、それを`<GTProvider>`コンポーネントに渡します。

```jsx title="src/App.js"
import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';

<GTProvider loadDictionary={loadDictionary}>
  <App />
</GTProvider>
```

<Callout>
  **質問:** [`loadTranslations`](/docs/react/api/config/load-translations) と [`loadDictionary`](/docs/react/api/config/load-dictionary) の違いは何ですか？

  * [`loadTranslations`](/docs/react/api/config/load-translations) は、アプリの翻訳を取得する際のカスタムの読み込み方法を定義するために使用します。
    たとえば、CDN、データベース、またはアプリのバンドルから翻訳を取得できます。
    これらは通常、CLI ツールで管理される機械生成の翻訳で、ユーザーが直接編集するのにはあまり向いていません。
  * [`loadDictionary`](/docs/react/api/config/load-dictionary) は、`gt-react` をスタンドアロンライブラリとして実装する場合を想定しています。
    ユーザーが独自の翻訳を用意し、翻訳インフラは使用しません。
</Callout>

***


## 注意

* `loadDictionary` は、アプリのカスタム翻訳を読み込むために使用します。
* `loadDictionary` で読み込んだ辞書は、[`loadTranslations`](/docs/react/api/config/load-translations) で読み込んだ翻訳より優先されます。

## 次のステップ

* 独自に翻訳を作成する場合は、[カスタム翻訳](/docs/react/concepts/stand-alone)を参照してください。
* カスタム翻訳ローダーの作成方法について詳しくは、[`loadTranslations`](/docs/react/api/config/load-translations)を参照してください。