Individuazione dei token
"Token discovery" è il modo in cui l'SDK capisce cosa tradurre, in automatico, dal modo in cui scrivi la tua UI. Ci sono quattro blocchi fondamentali, ciascuno per un diverso tipo di contenuto.
t() — una stringa inline
Il cavallo di battaglia. Chiamalo con il testo di partenza e restituisce la traduzione per la lingua corrente (o il testo di partenza stesso se quella lingua non è ancora pronta). La categoria facoltativa raggruppa frasi correlate e viene passata al traduttore automatico come contesto; i parametri sostituiscono i {placeholders}.
const t = useT();
// t(phrase, category?, params?)
t('Hello, {name}!', 'Greetings', { name });<Translate>: un blocco di contenuto
Racchiudi una regione di markup e l'SDK la suddivide in token come blocco di contenuto — ogni nodo di testo diventa una frase — poi ritraduce l'intero blocco a ogni cambio di lingua. È identificato da un ID stabile ricavato dal suo contenuto e dalla sua categoria, quindi lo stesso blocco viene riconosciuto tra un rendering e l'altro e dopo i ricaricamenti.
<Translate category="Home">
<p>Welcome to our store. Browse the catalog in your language.</p>
</Translate><Phrase> — una frase, con markup
Quando una frase contiene markup inline o interpolazione, <Phrase> la mantiene come unica unità traducibile: così "Ciao Sarah, hai 3 articoli" viene tradotta come un'unica frase naturale anziché in frammenti spezzati. Supporta parametri e pluralizzazione.
<Phrase category="Cart" params={{ name: 'Sarah', count: 3 }}>
Hi %name%, you have %count% items in your cart.
</Phrase>Segnaposto. Scrivi l'interpolazione come {name}. All'interno del markup in cui un framework riserva già { } (JSX, Vue, Svelte), scrivi invece %name%: l'SDK lo normalizza di nuovo in {name} quando acquisisce la frase.
<DontTranslate>: lascialo com'è
Nomi di brand, codice, identificatori, indirizzi: contrassegna un'area da non tradurre mai. Viene resa come translate="no" e viene ignorata del tutto dal rilevamento.
<p>Welcome! <DontTranslate>This sentence always stays in English.</DontTranslate> Thanks for visiting!</p>La scoperta delle frasi avviene solo con una chiave di scrittura. Nel browser distribuisci una chiave di sola lettura, quindi l'SDK non registra nulla: recupera soltanto le traduzioni già esistenti. La registrazione è un'attività da fare in fase di sviluppo. Vedi Chiavi e ambienti.