Plurais e seleções

Apresente alternativas gramaticais completas para quantidades e estados da aplicação, com formas de recurso explícitas.

A diferença entre «1 ficheiro está pronto» e «2 ficheiros 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 o idioma selecionado possa expressar corretamente a mensagem na íntegra.

Escolher uma forma com base numa 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 devolve 2 files are ready for Ana.. Num catálogo traduzido, são as regras de pluralização cardinal do idioma ativo que 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) requer uma forma other. As categorias opcionais são zero, one, two, few e many. As opções requerem context e aceitam um mapa de valores adicionais de texto ou numéricos. # apresenta a contagem; a própria função auxiliar fornece o argumento count e substitui qualquer count presente nesse mapa.

A função auxiliar constrói uma mensagem ICU pela ordem zero, one, two, few, many, other. A extração utiliza o mesmo construtor, pelo que alterar a ordem das propriedades não altera a identidade. Alterar uma forma ou o respetivo contexto pode alterar a identidade. Mantenha as formas como literais para permitir a extração.

Escolher uma forma com base num valor da aplicação #

Utilize select para uma escolha exata entre categorias:

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 o l acima, o resultado é View your work. Se a função for desconhecida, é utilizado other. Mantenha os códigos da aplicação, como admin, separados dos rótulos traduzidos apresentados na interface, para que mudar de idioma não altere o estado selecionado.

select(value: string, forms: SelectForms, options: { context: string }): string requer other, ordena alfabeticamente as chaves das formas ao construir o respetivo código-fonte ICU e fornece o argumento value. Esta função auxiliar não dispõe de uma opção para valores adicionais.

Expressar contagens exatas e ordinais com texto ICU #

A função auxiliar de plurais disponibiliza categorias cardinais. Para uma alternativa exata =0, utilize o exemplo de ICU em bruto. Para um ordinal, utilize uma mensagem l.text literal:

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. Um modelo de destino precisa de uma expressão própria do idioma de destino; traduzir o resto da interface não torna os sufixos ingleses adequados a outros idiomas.

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