概要

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

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

この関数は主に、既存の翻訳を維持したまま、i18n 対応済みの既存プロジェクトを General Translation に移行する際に使用されます。

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

リファレンス

パラメータ

説明

戻り値

指定された locale の翻訳を id にマッピングした dictionary を返す Promise<any>。

セットアップ

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

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 で読み込まれた dictionary は、loadTranslations で読み込まれた翻訳よりも優先されます。

次のステップ

• 自分で翻訳を作成したい場合は、custom translations を参照してください。
• 独自の翻訳ローダーの実装については、loadTranslations を参照してください。