# gt-next: General Translation Next.js SDK: DictionaryTranslationOptions
URL: https://generaltranslation.com/fr/docs/next/api/types/dictionary-translation-options.mdx
---
title: DictionaryTranslationOptions
description: Référence de l’API pour le type DictionaryTranslationOptions
---

## Vue d’ensemble

Le type `DictionaryTranslationOptions` sert à transmettre des variables aux entrées de dictionnaire et à définir leur comportement de rendu.
Il est utilisé avec [`useTranslations`](/docs/next/api/dictionary/use-translations) et [`getTranslations`](/docs/next/api/dictionary/get-translations) pour transmettre des variables aux entrées de dictionnaire.

<Callout>
  **Traduction à la compilation :**
  Les variables ne sont pas traduites avec [`useTranslations`](/docs/next/api/dictionary/use-translations) et [`getTranslations`](/docs/next/api/dictionary/get-translations) ; seule la chaîne d’origine l’est.
  Consultez [`tx`](/docs/next/api/strings/tx) pour traduire des chaînes avec du contenu dynamique.
</Callout>

## Référence

### Paramètres

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Description

| Prop         | Description                                                                                                                                                                                                           |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `[variable]` | Les variables sont transmises sous forme de clés de premier niveau dans l’objet d’options. Les noms de ces clés correspondent aux paramètres de substitution de l’entrée de dictionnaire (par exemple, `{username}`). |

***

## Exemples

### Passage de variables

Pour passer une variable à une entrée de dictionnaire, nous devons faire deux choses : (1) ajouter une variable à l’entrée et (2) faire référence à cette variable dans l’appel à [`d`](/docs/next/api/strings/use-gt).

Commencez par ajouter une variable à l’entrée avec la syntaxe suivante : `{username}`.
`username` est le nom de la variable.

```jsx title="dictionary.ts"
// [!code word:username]
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!',
  },
};

export default dictionary;
```

Ensuite, nous faisons référence à la variable :

```jsx title="Component.tsx"
// [!code word:username]
import { useTranslations } from 'gt-next';

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

### Utilisation du format de messages ICU

`gt-next` prend en charge le format de messages ICU, ce qui vous permet également de formater vos variables.

```jsx title="dictionary.ts"
// [!code word:account-balance]
const dictionary = {
  account: {
    balance: 'Solde de votre compte : {dollars, number, ::currency/USD} !',
  },
};

export default dictionary;
```

Ensuite, nous utilisons la variable :

```jsx title="Component.tsx"
// [!code word:account-balance]
import { useTranslations } from 'gt-next';

const Component = () => {
  const t = useTranslations();
  return <div>
    { t(
      'account.balance',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};
```

***


## Remarques

* Les variables sont transmises comme des clés de premier niveau dans l’objet d’options, et non imbriquées sous la clé `variables`.

### Prochaines étapes

* Consultez [dictionnaires](/docs/next/guides/dictionaries) pour en savoir plus sur les dictionnaires et les pratiques courantes.
* Consultez [`useTranslations`](/docs/next/api/dictionary/use-translations) ou [`getTranslations`](/docs/next/api/dictionary/get-translations) pour en savoir plus sur l’interface des dictionnaires.
* Consultez le [`format de message ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) pour en savoir plus sur les options de mise en forme.