loadDictionary()

概要

loadDictionary() は、指定したロケールの翻訳用 json ファイルを読み込みます。

この関数は、gt-next を単体の i18n ライブラリとして使用したい方のために用意されています。

この関数は主に、既存の i18n プロジェクトを General Translation に移行しつつ、既存の翻訳を維持したい場合に使用されます。 セットアップ方法についてはこのガイドを参照してください。

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

リファレンス

パラメーター

説明

戻り値

指定されたロケールのIDと翻訳のマッピングを返す Promise<any>。

セットアップ

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

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

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

注意事項

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

次のステップ

• 自分で翻訳を書きたい場合は、カスタム翻訳をご覧ください。
• カスタム翻訳ローダーの作成方法については、loadTranslations()をご参照ください。