复数与选择

为不同数量和应用状态呈现语法完整的备选表达,并明确指定回退形式。

“1 个文件已就绪”和“2 个文件已就绪”在英语中的差别不只是名词的变化,其他语言也有各自的区分方式。为运行时提供完整的备选表达,让所选语言能够正确表达整条消息。

根据数量选择形式 #

ts
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 按类别进行精确选择:

ts
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 消息:

ts
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 表示,并渲染这些测试用例,验证实际采用的语法分支。