概要

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

この関数は、gt-react を単体の i18n ライブラリとして利用したい方向けです。

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

複数の翻訳が存在する場合、loadDictionary で読み込まれた dictionaries の翻訳が常に他よりも優先されます。 loadDictionary は、文字列の翻訳を含む JSON ファイルのみをサポートします。

リファレンス

パラメータ

説明

戻り値

指定された locale の翻訳で、id を対応する文字列にマッピングした dictionary を解決値とする Promise<any>。

セットアップ

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

loadDictionary をファイルに定義します。 指定された locale の翻訳を含むオブジェクトに解決される Promise を返すように関数を実装してください。

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

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

import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';

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

注意事項

• loadDictionary は、アプリのカスタム翻訳を読み込むために使用します。
• loadDictionary で読み込まれた dictionaries は、loadTranslations で読み込まれた翻訳よりも優先されます。

次のステップ

• 独自の翻訳を作成したい場合は、カスタム翻訳を参照してください。
• カスタム翻訳ローダーの実装については、loadTranslationsを参照してください。