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

## 概要

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

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

主に、既存の翻訳を維持したまま、i18n を導入済みの既存プロジェクトを General Translation に移行する際に使用します。
セットアップ方法については、[このガイド](/docs/next/guides/migration)を参照してください。

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

## リファレンス

### パラメーター

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

### 説明

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

### 戻り値

指定されたロケールについて、id から翻訳へのマッピングを含む辞書に解決される `Promise<any>`。

***

## セットアップ

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

`src/` ディレクトリまたはルートに `loadDictionary.js` または `loadDictionary.ts` という名前のファイルを作成し、そのデフォルトエクスポートとして `loadDictionary` を定義します。
この関数は、指定されたロケールの翻訳を含むオブジェクトに解決される Promise を返すようにしてください。

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

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

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

***


## 注意

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

## 次のステップ

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