Présentation

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

Utilisation

Le paramètre $maxChars s’applique à tous les appels de traduction de chaînes de caractères :

gt('Welcome to our application', { $maxChars: 20 })
// L'IA tente une traduction en 20 caractères : « Bienvenido a app »

Gestion de la limite 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 respecte la longueur spécifiée.

2. Troncature par la bibliothèque : si une traduction (provenant de l’IA ou du cache) dépasse la limite de caractères, la bibliothèque applique une troncature adaptée à la locale pour faire respecter la 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

Fonctionne avec vos solutions de traduction existantes :

gt('Notification utilisateur', {
  $context: 'mobile-alert',
  $maxChars: 30
})
// L'IA tente de traduire en 30 caractères : "Notification utilisateur"
// La bibliothèque tronque si nécessaire : "Notification utilisateur…"

Le paramètre affecte le hachage des traductions, de sorte que des limites de caractères différentes produisent des entrées de traduction distinctes.