loadDictionary()

概要

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

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

この関数は、既存のi18nプロジェクトを既存の翻訳を保持しながらGeneral Translationに移行するために主に使用されます。

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

リファレンス

パラメータ

Prop	Type	Default
`locale?`	`string`	-

説明

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

戻り値

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

セットアップ

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

ファイル内で loadDictionary() を定義します。この関数が、指定されたロケールの翻訳を含むオブジェクトに解決するプロミスを返すことを確認してください。

src/loadDictionary.js

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

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

src/App.js

import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';
 
<GTProvider loadDictionary={loadDictionary}>
  <App />
</GTProvider>

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

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

メモ

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

次のステップ

独自の翻訳を書きたい場合は、カスタム翻訳をチェックしてください。
カスタム翻訳ローダーの作成に関する詳細は、loadTranslations()を参照してください。

loadDictionary()

このページについて