概要

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

この関数は、gt-next をスタンドアロンの i18n ライブラリとして使用したい方向けです。

この関数は主に、既存の翻訳を維持したまま、i18n 対応済みの既存プロジェクトを General Translation に移行する際に使用します。 セットアップ手順はこちらのガイドをご覧ください。

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

リファレンス

パラメータ

説明

戻り値

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

セットアップ

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

loadDictionary は、src/ ディレクトリまたはプロジェクトルートにある loadDictionary.js もしくは loadDictionary.ts というファイルで、デフォルトエクスポートとして定義してください。 この関数が、指定された locale の翻訳を含むオブジェクトに解決される Promise を返すことを必ず確認してください。

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

注意事項

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

次のステップ

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