Plurales y selecciones
Muestra alternativas gramaticales completas para cantidades y estados de la aplicación, con formas alternativas explícitas para los casos no contemplados.
Entre «1 archivo está listo» y «2 archivos están listos» cambia algo más que el sustantivo. Otros idiomas establecen distinciones diferentes. Proporciona alternativas completas al entorno de ejecución para que el idioma seleccionado pueda expresar correctamente el mensaje completo.
Elige una forma según una cantidad #
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 ejemplo en el idioma de origen devuelve 2 files are ready for Ana.. En un catálogo traducido, las reglas de plural cardinal del idioma activo determinan qué forma se selecciona. La categoría one es una categoría gramatical, no una comprobación universal de que el valor sea el entero 1.
plural(count: number, forms: PluralForms, options) requiere una forma other. Las categorías opcionales son zero, one, two, few y many. Las opciones requieren context y admiten un mapa de valores adicionales de tipo cadena o número. # muestra la cantidad; la propia función auxiliar proporciona el argumento count y sobrescribe cualquier count de ese mapa.
La función auxiliar construye un mensaje ICU en este orden: zero, one, two, few, many, other. La extracción utiliza el mismo constructor, por lo que cambiar el orden de las propiedades no altera la identidad. Cambiar una forma o su contexto sí puede alterarla. Mantén las formas como literales para la extracción.
Elige una forma según un valor de la aplicación #
Usa select para seleccionar una categoría por coincidencia exacta:
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" },
);Con el l anterior, se devuelve View your work. Si el rol es desconocido, se utiliza other. Mantén los códigos de la aplicación, como admin, separados de las etiquetas traducidas que se muestran, para que cambiar de idioma no altere el estado seleccionado.
select(value: string, forms: SelectForms, options: { context: string }): string requiere other, ordena alfabéticamente las claves de las formas al construir su código fuente ICU y proporciona el argumento value. Esta función auxiliar no dispone de una opción para valores adicionales.
Expresa cantidades exactas y ordinales con texto ICU #
La función auxiliar de plurales ofrece categorías cardinales. Para una alternativa que coincida exactamente con =0, usa el ejemplo con texto ICU sin procesar. Para un ordinal, usa un mensaje literal 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 },
},
);El resultado en inglés es 2nd. La plantilla de destino debe usar la expresión propia de ese idioma; traducir el resto de la interfaz no hace que los sufijos ingleses sean adecuados en otros idiomas.
Prueba el cero, el uno y las categorías representativas de cada idioma de destino, además de un valor de selección desconocido. Las restricciones de los mensajes generados limitan text y rich; las funciones auxiliares de plurales y selecciones conservan sus propios tipos de formas y opciones. Examina sus representaciones ICU extraídas y renderiza los casos para comprobar qué vías gramaticales se siguen realmente.