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

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


## 概要

`loadTranslations` 関数は、翻訳の読み込み方法をカスタマイズするための主な手段です。

本番環境では、翻訳をアプリでレンダリングできるよう、どこかに保存しておく必要があります。
デフォルトでは、翻訳は GT CDN に保存されます。
`loadTranslations` 関数を指定すると、次のような別のソースから翻訳を取得できます。

* アプリのバンドルから (最も一般的) 
* データベースから
* API から
* 別の CDN から

アプリのバンドル内にあるローカルファイルから翻訳を読み込むためのサポートが組み込まれています。
React アプリでローカル翻訳を設定するには、[こちらのガイド](/docs/react/guides/local-tx)を参照してください。

## リファレンス

### パラメータ

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

### 説明

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

### 戻り値

指定したロケールの翻訳を含む文字列または JSX オブジェクトのいずれかに解決される `Promise<any>` を返します。

***

## セットアップ

`loadTranslations` 関数をインポートし、`<GTProvider>` コンポーネントのプロパティとして渡す必要があります。

```jsx title="src/index.js"
import loadTranslations from './loadTranslations';

createRoot(document.getElementById("root")!).render(
  <StrictMode>
    <GTProvider locales={['es', 'fr']} loadTranslations={loadTranslations}> // [!code highlight]
      <App />
    </GTProvider>
  </StrictMode>
);
```

***


## 使用例

### ローカルファイルから翻訳を読み込む

[ローカル翻訳](/docs/react/guides/local-tx)を使用するように設定している場合、[`gt translate`](/docs/cli/translate)コマンドを実行すると、翻訳は`./src/_gt`ディレクトリに保存されます。

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


### 独自のCDNから翻訳を読み込む

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const translations = await fetch(`https://your-cdn.com/translations/${locale}.json`);
    const data = await translations.json();
    return data;
  } catch (e) {
    console.error(e);
    return {};
  }
};
```

***


## 注意事項

* `loadTranslations` を使うと、本番環境のアプリで翻訳の読み込み方法をカスタマイズできます。
* 最も一般的な用途は、[ローカル翻訳](/docs/react/guides/local-tx) を追加することです

## 次のステップ