Opzioni di traduzione in runtime
Riferimento API per il tipo RuntimeTranslationOptions
Panoramica
Il tipo RuntimeTranslationOptions viene utilizzato per passare variabili alle traduzioni inline e definirne il comportamento di rendering.
Puoi anche aggiungere una locale per specificare una lingua diversa per la traduzione.
Questo si usa con la funzione tx.
Traduzione a runtime:
Per tradurre una variabile su richiesta, includila direttamente nella stringa passata a tx.
Le variabili passate a tx tramite l'oggetto options non vengono tradotte.
Riferimenti
Parametri
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
variables | Un oggetto in cui le chiavi indicano a quale punto della stringa viene assegnato ciascun valore. |
$locale | Puoi includere $locale come variabile nell'oggetto variables per specificare la lingua/locale della traduzione. In mancanza, verrà utilizzata la lingua/locale preferita del browser tra quelle supportate dalla tua app. |
Esempi
Passaggio di variabili
Per aggiungere una variabile alla stringa, utilizziamo la sintassi {variable-name}, in cui le parentesi graffe racchiudono il nome della variabile.
import { tx } from 'gt-next/server';
const Component = () => {
return <div>
{tx(`Ciao, {username}!`,{ username: 'Brian123' })}
</div>;
};Uso del formato di messaggi ICU
gt-next supporta il formato di messaggi ICU, che consente anche di formattare le variabili.
import { tx } from 'gt-next/server';
const Component = () => {
return <div>
{ tx(
'Saldo del conto: {dollars, number, ::currency/USD}!',
{
"dollars" : 1000000,
}
) }
</div>;
};Traduzione delle variabili
Per tradurre una variabile, includila direttamente nella stringa passata a tx.
import { tx } from 'gt-next/server';
const Component = ({ hairColor }: { hairColor: string }) => {
return <div>{tx(
`Ciao, {username}! Il colore dei tuoi capelli è ${hairColor}`,
{ username: 'Brian123' }
)}</div>;
};Nota che la variabile hairColor viene tradotta, mentre username no.
Specificare una lingua/locale
Puoi specificare la lingua/locale da usare per la traduzione.
import { tx } from 'gt-next/server';
const Component = () => {
return <div>{tx('Ciao, mondo!', { $locale: 'fr' })}</div>;
};Questo verrà sempre tradotto in francese.
Note
RuntimeTranslationOptionsviene utilizzato per le traduzioni di stringhe a runtime.- L'oggetto
variablespassa i valori al testo. - L'oggetto
variablesOptionsdefinisce il comportamento delle variabili.
Prossimi passaggi
- Vedi
txper ulteriori informazioni sulle traduzioni di stringhe inline. - Vedi il
formato dei messaggi ICUper ulteriori informazioni sulle opzioni di formattazione.
Come valuti questa guida?