Types

DictionaryTranslationOptions

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

Vue d’ensemble

Le type DictionaryTranslationOptions est utilisé pour passer des variables aux entrées du dictionary et préciser leur comportement de rendu. Il est utilisé avec useTranslations et getTranslations pour passer 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érence

Paramètres

Prop

Type

Description

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

Exemples

Transmission de variables

Pour transmettre une variable à l’entrée du dictionary, nous devons effectuer deux actions : (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 référence à la variable :

Component.tsx
import { useTranslations } from 'gt-next';

const Component = () => {
  const d = useTranslations();
  return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};

Utilisation du format de message ICU

gt-next prend en charge le format de message ICU, ce qui vous permet aussi 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 entrée du dictionary.
  • L’objet variablesOptions définit le comportement des variables.

Prochaines étapes

Comment trouvez-vous ce guide ?