Types

DictionaryTranslationOptions

Référence de l’API pour le type DictionaryTranslationOptions

Vue d’ensemble

Le type DictionaryTranslationOptions est utilisé pour transmettre des variables aux entrées du dictionary et spécifier leur comportement de rendu. Il est utilisé avec useTranslations et getTranslations pour transmettre des variables aux entrées du dictionary.

Buildtime Translation : Les variables ne sont pas traduites avec useTranslations et getTranslations ; seule la chaîne d’origine l’est. Consultez tx pour traduire des chaînes avec du contenu dynamique.

Références

Paramètres

Prop

Type

Description

PropDescription
variablesUn objet dont les clés indiquent où chaque valeur est associée dans l’Entry du dictionary.

Exemples

Passage de variables

Pour transmettre une variable à l’entrée du dictionary, nous devons faire deux choses : (1) ajouter une variable à l’entrée et (2) référencer cette variable dans l’appel à d.

D’abord, nous ajoutons une variable à l’entrée du dictionary avec la syntaxe suivante : {username}. username est le nom de la variable.

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

export default dictionary;

Ensuite, nous faisons appel à 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, ce qui vous permet également de formater vos variables.

dictionary.ts
const dictionary = {
  account: {
    balance: 'Solde de votre compte : {dollars, number, ::currency/USD} !',
  },
};

export default dictionary;

Ensuite, nous faisons appel à 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 Entry du dictionary.
  • L’objet variablesOptions définit le comportement des variables.

Prochaines étapes

Que pensez-vous de ce guide ?

DictionaryTranslationOptions