Opzioni di traduzione inline
Riferimento API per il tipo InlineTranslationOptions
Panoramica
Il tipo InlineTranslationOptions viene usato per passare variabili alle traduzioni inline e per definirne il comportamento di rendering.
Puoi anche aggiungere un contesto e un identificatore alla traduzione.
Si usa con useGT, getGT e msg per passare variabili alle traduzioni inline delle stringhe.
Traduzione in fase di build:
Con useGT, getGT e msg vengono tradotte solo le stringhe originali, non le variabili.
Vedi tx per tradurre stringhe con contenuto dinamico.
Riferimenti
Parametri
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
variables | Un oggetto in cui le chiavi indicano a cosa viene associato ciascun valore nella stringa. |
$context | Facoltativamente, includi $context come variabile nell'oggetto variables per fornire contesto al contenuto (usato per la traduzione). |
$id | Facoltativamente, includi $id come variabile nell'oggetto variables per fornire un identificatore da usare con l'editor di traduzione. |
Esempi
Contesto
Per aggiungere contesto alla stringa, utilizziamo la prop $context.
import { useGT } from 'gt-next';
const Component = () => {
const t = useGT();
return <div>{t('Hello, world!', { $context: 'saluto formale' })}</div>;
};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 { useGT } from 'gt-next';
const Component = () => {
const t = useGT();
return <div>{t('Ciao, {username}! Com’è la tua giornata?', { username: 'Brian123' })}</div>;
};Utilizzo del formato di messaggio ICU
gt-next supporta il formato di messaggio ICU, che consente di formattare anche le variabili.
import { useGT } from 'gt-next';
const Component = () => {
const t = useGT();
return <div>
{ t(
'Saldo del tuo conto: {dollars, number, ::currency/USD}!',
{
"dollars" : 1000000,
}
) }
</div>;
};Consulta la documentazione del formato di messaggistica ICU per ulteriori informazioni sul formato di messaggistica ICU.
Note
InlineTranslationOptionsviene usato per le traduzioni di stringhe inline.- L'oggetto
variablespassa i valori al testo. - L'oggetto
variablesOptionsdefinisce il comportamento delle variabili.
Prossimi passaggi
- Consulta
useGTegetGTper ulteriori informazioni sulle traduzioni di stringhe inline. - Consulta il
formato dei messaggi ICUper ulteriori informazioni sulle opzioni di formattazione.
Come valuti questa guida?