Panoramica

gt-next@6.11.0 aggiunge il supporto per il parametro $maxChars nelle funzioni di traduzione, sulla base della funzionalità formatCutoff() introdotta in generaltranslation@8.1.0.

Utilizzo

Il parametro $maxChars funziona con qualsiasi chiamata di traduzione di stringhe:

gt('Welcome to our application', { $maxChars: 20 });
// L'IA tenta la traduzione entro 20 caratteri: "Bienvenido a app"

Gestione del limite di caratteri

Il parametro $maxChars attiva due meccanismi distinti:

1. Ottimizzazione della traduzione tramite IA: l'IA riceve il limite di caratteri e cerca di produrre una traduzione che rientri nella lunghezza specificata.

2. Troncamento della libreria: se una traduzione (dall'IA o dalla cache) supera il limite di caratteri, la libreria applica un troncamento in base all'impostazione regionale per rispettare il limite.

gt('Long description text', { $maxChars: 15 });
// L'IA tenta una traduzione concisa: "Texto breve"
// Se il risultato supera il limite: "Texto de desc…" (troncato)

Integrazione

Funziona con le opzioni di traduzione esistenti:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30,
});
// L'IA tenta la traduzione entro 30 caratteri: "Notificación usuario"
// La libreria tronca se necessario: "Notificación del usuario…"

Il parametro influisce sull'hashing delle traduzioni e garantisce che limiti di caratteri diversi creino voci di traduzione separate.