复数与选择
为不同数量和应用状态呈现语法完整的备选表达,并明确指定回退形式。
“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。目标模板需要采用目标语言的表达方式;仅仅翻译周围的界面,并不能让英语后缀也适用于其他语言。
针对每种目标语言,测试零、一以及具有代表性的类别,同时测试一个未知的选择值。生成消息约束会收窄 text 和 rich 的范围;复数和选择辅助函数则保留各自的形式与选项类型。检查提取出的 ICU 表示,并渲染这些测试用例,验证实际采用的语法分支。