loadDictionary()

概要

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

この関数は、gt-next をスタンドアロンのi18nライブラリとして使用したい人向けに設計されています。

この関数は主に、既存のi18nプロジェクトを既存の翻訳を維持しながらGeneral Translationに移行するために使用されます。これを設定するには、このガイドに従ってください。

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

リファレンス

パラメーター

Prop	Type	Default
`locale?`	`string`	-

説明

タイプ	説明
`locale`	翻訳を読み込むべきロケール。

戻り値

指定されたロケールの翻訳をidにマッピングする辞書に解決されるPromise<any>。

セットアップ

一般的に、辞書は ./public/locales ディレクトリからロードされます。

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

src/loadDictionary.js

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

質問: loadTranslations() と loadDictionary() の違いは何ですか？

loadTranslations() は、アプリの翻訳を取得するためのカスタムロード動作を定義するために使用されます。これは、CDN、データベース、またはアプリのバンドルから翻訳を取得することができます。これらは通常、CLIツールによって管理される機械生成の翻訳であり、編集があまりユーザーフレンドリーではありません。
loadDictionary() は、gt-next をスタンドアロンライブラリとして実装するために意図されています。ユーザーは自分自身の翻訳を持ち込み、翻訳インフラストラクチャは使用されません。

メモ

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

次のステップ

独自の翻訳を書きたい場合は、カスタム翻訳をチェックしてください。
カスタム翻訳ローダーの書き方については、loadTranslations()をご覧ください。

loadDictionary()

このページについて