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

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


## 概要

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

この関数は、`gt-react-native` をスタンドアロンの 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-native';
import loadDictionary from './loadDictionary';

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

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

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

***


## 注意

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

## 次のステップ

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