OpzioniTraduzioneInLinea
Riferimento API per il tipo InlineTranslationOptions
Panoramica
Il tipo InlineTranslationOptions viene utilizzato per passare variabili alle traduzioni inline e definirne il comportamento di rendering.
Puoi anche aggiungere contesto e un identificatore alla traduzione.
Si usa con useGT e msg per passare variabili alle traduzioni di stringhe inline.
Traduzione in fase di build:
Le traduzioni con useGT e msg avvengono in fase di build; tuttavia, le variabili non vengono mai tradotte.
Vengono invece inserite nella traduzione con la relativa formattazione.
Assicurati di seguire la guida al deployment.
Riferimenti
Parametri
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
variables | Un oggetto in cui le chiavi indicano a quale punto della stringa viene assegnato ciascun valore. |
$context | Includi facoltativamente $context come variabile nell'oggetto variables per fornire contesto al contenuto (usato per la traduzione). |
$id | Includi facoltativamente $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-react';
const Component = () => {
const t = useGT();
return <div>{t('Salve, mondo!', { $context: 'un saluto formale' })}</div>;
};Passaggio di variabili
Per aggiungere una variabile alla stringa, utilizziamo la sintassi {variable-name}, dove il nome della variabile è racchiuso tra parentesi graffe.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>{t('Ciao, {username}! Com’è la tua giornata?', { username: 'Brian123' })}</div>;
};Uso del formato di messaggi ICU
gt-react supporta il formato di messaggi ICU, che consente anche di formattare le variabili.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>
{ t(
'Saldo del conto: {dollars, number, ::currency/USD}!',
{
"dollars" : 1000000,
}
) }
</div>;
};Consulta la documentazione sul formato dei messaggi ICU per ulteriori informazioni sul formato dei messaggi ICU.
Note
InlineTranslationOptionsviene usato per tradurre stringhe inline.- L’oggetto
variablespassa i valori al testo. - L’oggetto
variablesOptionsdefinisce il comportamento delle variabili.
Prossimi passi
- Consulta
useGTper ulteriori informazioni sulle traduzioni in linea delle stringhe. - Consulta il
formato dei messaggi ICUper ulteriori informazioni sulle opzioni di formattazione.
Come valuti questa guida?