DictionaryTranslationOptions
Référence API pour le type DictionaryTranslationOptions
Aperçu
Le type DictionaryTranslationOptions
est utilisé pour passer des variables aux entrées de dictionnaire et spécifier leur comportement de rendu.
Il est utilisé avec useTranslations()
et getTranslations()
pour passer des variables aux entrées de dictionnaire.
Traduction au moment de la compilation :
Les variables ne sont pas traduites avec useTranslations()
et getTranslations()
, seulement la chaîne originale.
Voir tx()
pour traduire des chaînes avec du contenu dynamique.
Référence
Paramètres
Prop | Type | Default |
---|---|---|
variables?? | Record<string, any> | undefined |
Description
Prop | Description |
---|---|
variables | Un objet où les clés identifient où chaque valeur est mappée dans l'entrée du dictionnaire. |
Exemples
Passer des variables
Pour passer une variable à l'entrée du dictionnaire, nous devons faire deux choses : (1) ajouter une variable à l'entrée et (2) référencer cette variable dans l'invocation de d()
.
D'abord, nous ajoutons une variable à l'entrée du dictionnaire avec la syntaxe suivante : {username}
.
username
est le nom de la variable.
const dictionary = {
greeting: {
hello: 'Hello, {username}!',
},
};
export default dictionary;
Ensuite, nous référençons la variable :
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};
Utiliser le format de message ICU
gt-next
prend en charge le format de message ICU, qui vous permet également de formater vos variables.
const dictionary = {
account: {
balance: 'Your account balance: {dollars, number, ::currency/USD}!',
},
};
export default dictionary;
Ensuite, nous référençons la variable :
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>
{ d(
'account.balance',
{
"dollars" : 1000000,
}
) }
</div>;
};
Notes
- L'objet
variables
transmet des valeurs à une entrée de dictionnaire. - L'objet
variablesOptions
définit le comportement des variables.
Étapes suivantes
- Voir dictionaries pour plus d'informations sur les dictionnaires et les pratiques courantes.
- Voir
useTranslations()
ougetTranslations()
pour plus d'informations sur l'interface des dictionnaires. - Voir
ICU message format
pour plus d'informations sur les options de formatage.
Comment trouvez-vous ce guide ?