複数形と選択
数量やアプリケーションの状態に応じて、文法的に完結した表現を表示し、どの条件にも当てはまらない場合の形式も明示します。
英語では、「ファイルが1個準備できています」と「ファイルが2個準備できています」に当たる文で、名詞以外も変化します。他の言語では、また異なる区別が必要です。選択した言語でメッセージ全体を正しく表現できるよう、実行時に使う各候補には、完結した表現を指定してください。
数量に応じて形式を選ぶ #
import { createLingo } from "@lingo.dev/react";
const l = createLingo("en");
const message = l.plural(
2,
{
one: "# file is ready for {name}.",
other: "# files are ready for {name}.",
},
{ context: "Files ready for download", values: { name: "Ana" } },
);このソース言語の例では、2 files are ready for Ana.が返されます。翻訳済みのカタログでは、現在のロケールの基数ルールに従って形式が選ばれます。oneは文法上のカテゴリであり、すべての言語で整数の1かどうかを判定する条件ではありません。
plural(count: number, forms: PluralForms, options)にはother形式が必須です。任意で指定できるカテゴリは、zero、one、two、few、manyです。オプションにはcontextが必須で、追加の文字列や数値をマップで渡せます。#は個数を表示します。ヘルパー自体がcount引数を渡し、マップ内にcountがあれば上書きします。
ヘルパーは、zero、one、two、few、many、otherの順にICUメッセージを組み立てます。抽出時にも同じ構築処理を使うため、プロパティの順序を変えても識別情報は変わりません。ただし、形式やそのコンテキストを変更すると、識別情報が変わることがあります。抽出できるよう、各形式はリテラルで記述してください。
アプリケーションの値に応じて形式を選ぶ #
カテゴリの完全一致で形式を選ぶには、selectを使います。
const action = l.select(
"member",
{
admin: "Manage the team",
member: "View your work",
other: "Open your account",
},
{ context: "Primary navigation action for the signed-in account role" },
);上記のlでは、View your workが返されます。未知のロールにはotherが使われます。言語を切り替えても選択状態が変わらないよう、adminなどのアプリケーション内のコードは、翻訳対象の表示ラベルと分けてください。
select(value: string, forms: SelectForms, options: { context: string }): stringにはotherが必須です。ICUソースを組み立てる際に形式のキーをアルファベット順に並べ替え、value引数を渡します。このヘルパーには、追加の値を渡すオプションはありません。
ICUテキストで特定の個数と序数を表現する #
複数形ヘルパーでは、基数カテゴリを利用できます。=0に完全一致する場合の表現には、ICUを直接記述する例を使ってください。序数には、リテラルのl.textメッセージを使います。
const position = l.text(
"{position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}",
{
context: "Finishing position in a ranked result, using English source suffixes",
values: { position: 2 },
},
);英語での結果は2ndです。翻訳先のテンプレートには、その言語に合った表現が必要です。周囲の画面を翻訳するだけでは、英語の接尾辞を他の言語でも適切に使えるようにはなりません。
翻訳先の各言語について、ゼロ、1、代表的なカテゴリに加え、未知の選択値もテストしてください。生成されるメッセージの制約により、textとrichの型は絞り込まれます。複数形ヘルパーと選択ヘルパーは、それぞれ独自の形式とオプションの型を維持します。抽出されたICU表現を確認し、各ケースを表示して、実際にどの文法上の分岐が使われるかを検証してください。