Plurais e seleções

Renderize alternativas gramaticais completas para quantidades e estados da aplicação, com formas alternativas explícitas para os casos não previstos.

A diferença entre “1 arquivo está pronto” e “2 arquivos estão prontos” vai além do substantivo. Outros idiomas fazem distinções diferentes. Forneça alternativas completas ao ambiente de execução para que a mensagem inteira seja expressa corretamente no idioma selecionado.

Escolha uma forma com base em uma quantidade #

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" } },
);

Este exemplo no idioma de origem retorna 2 files are ready for Ana.. Em um catálogo traduzido, as regras de plural cardinal do idioma ativo determinam a forma. A categoria one é uma categoria gramatical, não um teste universal para o número inteiro 1.

plural(count: number, forms: PluralForms, options) exige uma forma other. As categorias opcionais são zero, one, two, few e many. As opções exigem context e aceitam um mapa de valores adicionais de texto ou número. # exibe a contagem; a própria função auxiliar fornece o argumento count e sobrescreve qualquer count nesse mapa.

A função auxiliar cria uma mensagem ICU na ordem zero, one, two, few, many, other. A extração usa o mesmo construtor, então mudar a ordem das propriedades não altera a identidade. Alterar uma forma ou seu contexto pode alterar a identidade. Mantenha as formas como literais para a extração.

Escolha uma forma com base em um valor da aplicação #

Use select para selecionar uma categoria por correspondência exata:

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" },
);

Com l acima, o resultado é View your work. Uma função desconhecida usa other. Mantenha os códigos da aplicação, como admin, separados dos rótulos de exibição traduzidos, para que uma mudança de idioma não altere o estado selecionado.

select(value: string, forms: SelectForms, options: { context: string }): string exige other, ordena as chaves das formas alfabeticamente ao criar seu código-fonte ICU e fornece o argumento value. Essa função auxiliar não oferece uma opção para valores adicionais.

Expresse contagens exatas e ordinais com texto ICU #

A função auxiliar de plural disponibiliza categorias cardinais. Para uma alternativa exata =0, use o exemplo em ICU puro. Para um ordinal, use uma mensagem literal 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 },
  },
);

O resultado em inglês é 2nd. O modelo de destino precisa usar a forma de expressão do idioma de destino; traduzir o restante da interface não torna os sufixos do inglês adequados a outros idiomas.

Teste zero, um e categorias representativas de cada idioma de destino, além de um valor de seleção desconhecido. As restrições das mensagens geradas limitam text e rich; as funções auxiliares de plural e seleção mantêm seus próprios tipos de formas e opções. Inspecione suas representações ICU extraídas e renderize os casos para verificar os caminhos gramaticais efetivamente usados.