Gérer les pluriels, les dates et les nombres

Laissez la langue déterminer la grammaire et la mise en forme, tout en gardant le contrôle des valeurs, des unités et des fuseaux horaires dans l’application.

Le décompte des éléments repose sur deux décisions : le nombre que l’application veut exprimer et la manière dont la langue du lectorat exprime cette quantité. La même distinction s’applique aux dates et aux montants monétaires. Conservez les valeurs sous une forme structurée jusqu’au rendu afin de choisir explicitement la grammaire, les séparateurs, la devise et le fuseau horaire.

Ces exemples utilisent @lingo.dev/react. Les systèmes de ressources natifs ont leur propre syntaxe de messages et leurs propres générateurs ; une notation de type ICU ne rend pas tous les environnements d’exécution interchangeables.

Fournir un message complet à l’outil de mise en forme #

Dans un composant placé sous LingoProvider, utilisez le nombre d’éléments dans un message avec gestion du pluriel :

tsx
const l = useLingo();

const label = l.plural(
  count,
  { one: "# item", other: "# items" },
  { context: "Number of items in the shopping cart" },
);

Importez useLingo depuis @lingo.dev/react ; count correspond à la valeur numérique de l’application. L’environnement d’exécution construit un message ICU et met en forme la traduction du catalogue selon la langue active. one et other sont des catégories grammaticales. Ajouter par concaténation un nom traduit après un nombre mis en forme ferait perdre la sélection de la catégorie et la possibilité de modifier l’ordre des mots.

La fonction utilitaire plural construit des catégories CLDR nommées ; elle n’inclut pas de branches correspondant à des nombres exacts, comme =0. Pour afficher un message propre au produit lorsque la valeur est zéro, utilisez le mécanisme de traitement du texte avec une expression ICU explicite :

ts
l.text("{count, plural, =0 {No items} one {# item} other {# items}}", {
  context: "Cart count with a distinct empty state",
  values: { count },
});

Les langues cibles peuvent nécessiter davantage de catégories que l’anglais. Examinez le message traduit et testez les formes sélectionnées selon sa langue, plutôt que d’imposer à toutes les langues les branches du texte source. Pluriels et sélections décrit les formes prises en charge et le fonctionnement de l’extraction.

Pour une variante sémantique, utilisez des valeurs de sélecteur stables :

ts
l.select(role, {
  admin: "Manage team settings",
  member: "View team settings",
  other: "View settings",
}, { context: "Settings action for the user's team role" });

L’application fournit role. Traduisez les messages des branches en conservant admin, member et la branche de repli obligatoire other. Une valeur inconnue utilise other.

Distinguer la position ordinale de la quantité cardinale #

Un ordinal indique une position. Utilisez l’outil de mise en forme ICU complexe du mécanisme de traitement du texte pour un message tel que :

ts
l.text("You finished {position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}", {
  context: "Participant's finishing position in a competition",
  values: { position },
});

Les suffixes sont propres au texte source anglais : ils ne constituent pas une règle universelle. La traduction cible doit exprimer la position dans sa propre langue. Fournir values active la mise en forme dans le mécanisme de traitement du texte ; les déclarations générées vérifient le contrat d’appel, mais ne valident pas chaque branche ICU imbriquée.

Préciser les devises et les unités de pourcentage #

Utilisez des montants numériques avec le code de devise correspondant :

ts
const price = l.currency(1234.5, "EUR");
const discount = l.percent(0.15);

Le premier appel met en forme un montant en euros ; il ne convertit pas une autre devise en euros. Le second représente quinze pour cent, car sa valeur d’entrée est une fraction. Fournir 15 représenterait une autre quantité. Pour insérer ces chaînes mises en forme dans une phrase, transmettez-les via des values nommés plutôt que de construire une nouvelle chaîne source.

Les fonctions utilitaires de mise en forme couvrent aussi les nombres, les unités, les listes et d’autres valeurs traitées par Intl. Vérifiez les paramètres par défaut et les options prises en charge par chaque fonction. La mise en forme adaptée à la langue ne traduit pas tous les libellés d’unités personnalisés, et des options non valides peuvent malgré tout provoquer un échec.

Choisir ce que représente la date et son fuseau horaire d’affichage #

Un horodatage représente un instant ; une date calendaire peut représenter un jour sans fuseau horaire. Ne transformez pas une échéance définie uniquement par une date en un instant à minuit, sauf si cette conversion correspond à ce que la date représente dans le produit.

Pour un instant, précisez le fuseau horaire d’affichage souhaité :

ts
const instant = new Date("2026-01-02T00:30:00Z");

const date = l.date(instant, { timeZone: "UTC" });
const time = l.time(instant, { timeZone: "UTC" });

Ces fonctions utilitaires utilisent la langue active pour la présentation et UTC comme fuseau horaire d’affichage. Vous pouvez aussi utiliser directement les API standard sous-jacentes :

ts
new Intl.NumberFormat("de-DE", {
  style: "currency", currency: "EUR",
}).format(1234.5);

new Intl.DateTimeFormat("en-US", {
  dateStyle: "medium", timeZone: "UTC",
}).format(new Date("2026-01-02T00:30:00Z"));

Respecter la grammaire prise en charge par les messages enrichis #

l.rich associe des balises nommées à des composants React et interpole des espaces réservés simples. Il n’utilise pas l’outil de mise en forme ICU complexe de l.text. Une phrase telle que « Consultez notre <link>politique de livraison</link> pour {region} » convient à ce mécanisme lorsque le code fournit le composant de rendu du lien et la valeur de la région. Y ajouter un pluriel ou un ordinal n’active pas la prise en charge d’ICU.

Conservez les définitions des interactions dans le code et choisissez une structure de message prise en charge lorsque contenu enrichi et grammaire se combinent. Les balises inconnues restent du texte littéral, et l’appariement des balises imbriquées de même nom est limité. Consultez Messages interactifs enrichis.

Vérifier les cas où le sens change #

Testez des décomptes de 0, 1 et 2 éléments, ainsi qu’un nombre plus élevé et un nombre décimal si le produit l’autorise. Pour les ordinaux anglais, incluez 1, 2, 3, 11, 12, 13 et 21 ; pour les langues cibles, utilisez les formulations attendues dans chaque langue. Testez une valeur de sélecteur inconnue, des montants négatifs lorsque cela a du sens et un même instant dans deux fuseaux horaires à proximité de minuit.

Chargez les catalogues réels des langues cibles pour ces vérifications. Une traduction manquante ou vide peut déclencher un repli sur le texte source ; un résultat plausible ne suffit donc pas à confirmer la couverture de la langue cible. Comparez les valeurs affichées à la quantité, à la date et au message voulus, puis procédez à une relecture du texte lui-même.