Panoramica

gt-next@6.11.0 aggiunge il supporto per il parametro $maxChars alle funzioni di traduzione, estendendo la funzionalità di formatCutoff() introdotta in generaltranslation@8.1.0.

Utilizzo

Il parametro $maxChars può essere utilizzato con qualsiasi chiamata di traduzione di stringhe:

gt('Welcome to our application', { $maxChars: 20 })
// L'AI tenta di tradurre entro 20 caratteri: "Benvenuto nell'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 da parte della libreria: Se qualsiasi traduzione (dall'IA o dalla cache) supera il limite di caratteri, la libreria applica un troncamento basato sul locale per far rispettare il limite.

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

Integrazione

Si integra con le opzioni di traduzione esistenti:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30
})
// L'AI tenta la traduzione entro 30 caratteri: "Notifica utente"
// La libreria tronca se necessario: "Notifica dell'utente…"

Il parametro influisce sul calcolo dell'hash delle traduzioni, garantendo che limiti di caratteri diversi generino voci di traduzione distinte.