Utility FunctionsLocales
determineLocale
determineLocale 関数のAPIリファレンス
概要
determineLocale 関数は、GT クラスのインスタンスなしに、ユーザーの設定に基づいて承認済みの対応ロケールから最適なロケールを決定します。
リファレンス
パラメータ
Prop
Type
返り値
string | undefined - 最も適合するlocale、または一致しない場合はundefined
例
コンテンツネゴシエーション
import { determineLocale } from 'generaltranslation';
const approvedLocales = ['en-US', 'es-ES', 'fr-FR', 'de-DE'];
// 完全一致
console.log(determineLocale('en-US', approvedLocales)); // 'en-US'
// 言語によるフォールバック
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'
// 複数の優先設定
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'
// 該当なし
console.log(determineLocale('it-IT', approvedLocales)); // undefined注意事項
- インテリジェントな locale ネゴシエーションを実装
- 承認済みリストから、完全一致または言語一致のうち最初のものを返す
- 入力配列の優先順位を尊重する
- 一致が見つからない場合は undefined を返す
- Web アプリケーションにおける locale ネゴシエーションに不可欠
次のステップ
- GT クラスのメソッド
determineLocaleを使う requiresTranslationで翻訳が必要か確認する
このガイドはどうでしたか？