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 s’utilise avec useTranslations pour passer des variables aux entrées du dictionary.

Buildtime Translation : Les traductions via useTranslations ont lieu au moment du build ; néanmoins, les variables ne sont jamais traduites. Elles sont insérées dans la traduction avec un formatage. Assurez-vous de suivre le guide de déploiement ici.

Référence

Paramètres

Prop

Type

Description

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

Exemples

Transmission de variables

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

Tout d’abord, nous ajoutons une variable à l’Entry du dictionary avec la syntaxe suivante : {username}. username est le name de la Variable.

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

export default dictionary;

Ensuite, nous référencions la variable :

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

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

Utiliser le format de message ICU

gt-react 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 référencerons la variable :

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

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

  • Voir dictionaries pour plus d’informations sur les dictionaries et les pratiques courantes.
  • Voir useTranslations pour plus d’informations sur l’interface des dictionaries.
  • Voir format de message ICU pour plus d’informations sur les options de formatage.

Comment trouvez-vous ce guide ?