Opzioni di traduzione del dizionario
Riferimento API per il tipo DictionaryTranslationOptions
Panoramica
Il tipo DictionaryTranslationOptions viene utilizzato per passare variabili alle voci del dizionario e definirne il comportamento di rendering.
Si usa con useTranslations e getTranslations per passare variabili alle voci del dizionario.
Traduzione in fase di build:
Le variabili non vengono tradotte con useTranslations e getTranslations, ma solo la stringa originale.
Consulta tx per tradurre stringhe con contenuto dinamico.
Riferimenti
Parametri
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
variables | Un oggetto in cui le chiavi indicano a quale posizione viene assegnato ciascun valore nella voce del dizionario. |
Esempi
Passaggio di variabili
Per passare una variabile a una voce del dizionario, dobbiamo fare due cose: (1) aggiungere una variabile alla voce e (2) fare riferimento a tale variabile nell’invocazione di d.
Per prima cosa, aggiungiamo una variabile alla voce del dizionario con la seguente sintassi: {username}.
username è il nome della variabile.
const dictionary = {
greeting: {
hello: 'Ciao, {username}!',
},
};
export default dictionary;Successivamente, facciamo riferimento alla variabile:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};Uso del formato di messaggi ICU
gt-next supporta il formato di messaggi ICU, che consente anche di formattare le variabili.
const dictionary = {
account: {
balance: 'Saldo del tuo account: {dollars, number, ::currency/USD}!',
},
};
export default dictionary;Successivamente, facciamo riferimento alla variabile:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>
{ d(
'account.balance',
{
"dollars" : 1000000,
}
) }
</div>;
};Note
- L’oggetto
variablespassa valori a una voce del dizionario. - L’oggetto
variablesOptionsdefinisce il comportamento delle variabili.
Prossimi passi
- Vedi dictionaries per ulteriori informazioni sui dizionari e sulle pratiche comuni.
- Vedi
useTranslationsogetTranslationsper ulteriori informazioni sull’interfaccia dei dizionari. - Vedi il
formato dei messaggi ICUper maggiori dettagli sulle opzioni di formattazione.
Come valuti questa guida?