Формы множественного числа и выбор вариантов

Выводите полные грамматические варианты для разных количеств и состояний приложения, явно задавая резервные формы.

В сообщениях «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 в этом словаре.

Вспомогательная функция собирает сообщение ICU в порядке zero, one, two, few, many, other. При извлечении используется тот же механизм сборки, поэтому перестановка свойств не меняет идентификатор сообщения. Изменение формы или её контекста может изменить идентификатор. Задавайте формы литералами, чтобы их можно было извлечь.

Как выбрать форму по значению приложения #

Используйте 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 и выведите варианты, чтобы проверить, какие грамматические формы выбираются на практике.