Plurales y selecciones
Renderiza alternativas gramaticales completas para cantidades y estados de la aplicación, con formas de respaldo explícitas.
Entre “1 archivo está listo” y “2 archivos están listos” cambia más que el sustantivo. Otros idiomas hacen otras distinciones. 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 cardinales del idioma activo determinan qué forma se usa. La categoría one es una categoría gramatical, no una prueba universal para el número 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 aceptan 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 en ese mapa.
La función auxiliar construye un mensaje ICU en el orden zero, one, two, few, many, other. La extracción usa el mismo constructor, por lo que cambiar el orden de las propiedades no cambia la identidad. Cambiar una forma o su contexto sí puede cambiarla. Mantén las formas como literales para la extracción.
Elige una forma según un valor de la aplicación #
Usa select para elegir una categoría 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 usa other. Mantén los códigos de la aplicación, como admin, separados de las etiquetas traducidas que se muestran, para que cambiar el idioma no cambie 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 ofrece una opción de valores adicionales.
Expresa cantidades exactas y ordinales con texto ICU #
La función auxiliar de plurales ofrece categorías cardinales. Para una alternativa exacta =0, usa el ejemplo de 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 necesita una expresión propia de ese idioma; traducir el resto de la interfaz no hace que los sufijos del inglés sean adecuados para 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. Revisa sus representaciones ICU extraídas y renderiza los casos para verificar las variantes gramaticales que realmente se usan.