Types

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

PropTypeDefault
variables??
Record<string, any>
undefined

Description

PropDescription
variablesUn 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.

dictionary.ts
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!',
  },
};

export default dictionary;

Ensuite, nous référençons la variable :

Component.tsx
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.

dictionary.ts
const dictionary = {
  account: {
    balance: 'Your account balance: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;

Ensuite, nous référençons la variable :

Component.tsx
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

Comment trouvez-vous ce guide ?