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

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


## 概要

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

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

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

アプリのバンドル内のローカルファイルから翻訳を読み込む機能が組み込まれています。
React Native アプリでローカル翻訳を設定するには、[こちらのガイド](/docs/react-native/guides/local-tx)に従ってください。

## リファレンス

### パラメーター

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

### 説明

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

### 戻り値

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

***

## セットアップ

`loadTranslations` 関数をインポートし、`<GTProvider>` コンポーネントの prop に指定する必要があります。

```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-native/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-native/guides/local-tx) を追加することです。

## 次のステップ