Vue d’ensemble

gt-next@6.11.0 ajoute la prise en charge du paramètre $maxChars dans les fonctions de traduction, sur la base de la fonctionnalité formatCutoff() introduite dans generaltranslation@8.1.0.

Utilisation

Le paramètre $maxChars fonctionne avec n’importe quel appel de traduction de chaîne :

gt('Welcome to our application', { $maxChars: 20 });
// L'IA tente de traduire en moins de 20 caractères : "Bienvenido a app"

Gestion des limites de caractères

Le paramètre $maxChars déclenche deux mécanismes distincts :

1. Optimisation de la traduction par l’IA : l’IA reçoit la limite de caractères et tente de produire une traduction qui tient dans la longueur spécifiée.

2. Troncature par la bibliothèque : si une traduction (issue de l’IA ou du cache) dépasse la limite de caractères, la bibliothèque applique une troncature adaptée au paramètre régional afin de respecter cette limite.

gt('Long description text', { $maxChars: 15 });
// L'IA tente une traduction concise : "Texto breve"
// Si le résultat dépasse la limite : "Texto de desc…" (tronqué)

Intégration

Compatible avec les solutions de traduction existantes :

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30,
});
// L'IA tente une traduction en moins de 30 caractères : "Notificación usuario"
// La bibliothèque tronque si nécessaire : "Notificación del usuario…"

Le paramètre influe sur le hachage des traductions, de sorte que des limites de caractères différentes créent des entrées de traduction distinctes.