Pluriels et sélections
Affichez des variantes grammaticales complètes pour les quantités et les états de l’application, avec des formes de repli explicites.
Entre « 1 fichier est prêt » et « 2 fichiers sont prêts », il n’y a pas que le nom qui change. D’autres langues établissent d’autres distinctions. Fournissez à l’environnement d’exécution des variantes complètes pour que le message entier soit grammaticalement correct dans la langue sélectionnée.
Choisir une forme en fonction d’une quantité #
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" } },
);Cet exemple dans la langue source renvoie 2 files are ready for Ana.. Dans un catalogue traduit, les règles de pluriel cardinal de la langue active déterminent la forme à utiliser. La catégorie one est une catégorie grammaticale, pas un test universel d’égalité avec l’entier 1.
plural(count: number, forms: PluralForms, options) nécessite une forme other. Les catégories facultatives sont zero, one, two, few et many. Les options nécessitent context et acceptent une table de valeurs supplémentaires de type chaîne ou nombre. # affiche le nombre ; la fonction utilitaire fournit elle-même l’argument count et remplace toute valeur count présente dans cette table.
La fonction utilitaire construit un message ICU dans l’ordre zero, one, two, few, many, other. L’extraction utilise le même générateur : changer l’ordre des propriétés ne modifie donc pas l’identité du message. En revanche, modifier une forme ou son contexte peut la changer. Conservez les formes sous forme de chaînes littérales pour permettre leur extraction.
Choisir une forme en fonction d’une valeur de l’application #
Utilisez select pour choisir une catégorie par correspondance exacte :
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" },
);Avec le l ci-dessus, cet exemple renvoie View your work. Un rôle inconnu utilise other. Séparez les codes de l’application, tels que admin, des libellés d’affichage traduits : un changement de langue ne modifiera ainsi pas l’état sélectionné.
select(value: string, forms: SelectForms, options: { context: string }): string nécessite other, trie les clés des formes par ordre alphabétique lors de la construction de sa source ICU et fournit l’argument value. Cette fonction utilitaire ne propose pas d’option permettant de fournir des valeurs supplémentaires.
Exprimer des quantités exactes et des ordinaux avec du texte ICU #
La fonction utilitaire de pluriel donne accès aux catégories cardinales. Pour une variante correspondant exactement à =0, utilisez l’exemple ICU brut. Pour un ordinal, utilisez un message l.text littéral :
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 },
},
);Le résultat en anglais est 2nd. Un modèle cible doit utiliser une formulation propre à la langue cible : traduire le reste de l’interface ne rend pas les suffixes anglais adaptés aux autres langues.
Testez zéro, un et des catégories représentatives pour chaque langue cible, ainsi qu’une valeur de sélection inconnue. Les contraintes des messages générés restreignent text et rich ; les fonctions utilitaires de pluriel et de sélection conservent leurs propres types de formes et d’options. Examinez leurs représentations ICU extraites et affichez les différents cas pour vérifier les branches grammaticales réellement utilisées.