# General Translation React SDKs (gt-react, gt-next): DictionaryTranslationOptions
URL: https://generaltranslation.com/fr/docs/react/reference/types/dictionary-translation-options.mdx
---

title: DictionaryTranslationOptions
description: Options pour transmettre des variables aux entrées du dictionnaire avec General Translation gt-react. Référence d’API de DictionaryTranslationOptions.

---

`DictionaryTranslationOptions` est l’objet d’options utilisé pour les recherches dans le dictionnaire. Il contient les variables d’interpolation insérées dans une entrée du dictionnaire. Il est accepté par la fonction renvoyée par [`useTranslations`](/docs/react/reference/hooks/use-translations).

*Ces options s’appliquent partout où [`useTranslations`](/docs/react/reference/hooks/use-translations) est disponible — `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`.*

## Vue d’ensemble [#overview]

Transmettez les variables d’interpolation sous forme de simples clés. Chaque clé correspond à un espace réservé `{name}` dans l’entrée du dictionnaire.

```typescript
type DictionaryTranslationOptions = {
  [variable: string]: unknown; // variables d'interpolation
};
```

*Remarque : dans `gt-react` v11, l’argument `options` de `useTranslations` a pour type `TranslationVariables` (`Record<string, unknown>`) ; `DictionaryTranslationOptions` est le nom de référence de cette structure. Les variables sont insérées dans la traduction avec une mise en forme, mais ne sont jamais traduites elles-mêmes.*

## Propriétés [#properties]

| Prop                      | Description                                                                           | Type                      |
| ------------------------- | ------------------------------------------------------------------------------------- | ------------------------- |
| [`variables`](#variables) | Valeurs d’interpolation, avec comme clés le nom de l’espace réservé utilisé dans l’entrée. | `Record<string, unknown>` |

### `variables` [#variables]

**Type** `Record<string, unknown>`

Chaque clé indique où sa valeur est insérée dans l’entrée du dictionnaire. Référencez une variable dans l’entrée à l’aide de la syntaxe `{name}` ; sa valeur est insérée telle quelle dans la chaîne traduite, sans être traduite. Les valeurs peuvent être mises en forme avec le [format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).

## Exemples [#examples]

```tsx title="dictionary.ts"
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!', // {username} est une variable d'interpolation
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

const Component = () => {
  const t = useTranslations();
  // Passer { username } pour remplir l'espace réservé {username}
  return <div>{t('greeting.hello', { username: 'Brian123' })}</div>;
};
```

```tsx title="dictionary.ts"
const dictionary = {
  account: {
    // ICU message format formate la variable en Currency
    balance: 'Your account balance: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

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

## Remarques [#notes]

* `DictionaryTranslationOptions` s’utilise avec [`useTranslations`](/docs/react/reference/hooks/use-translations) pour passer des variables aux entrées du dictionnaire.
* Pour la traduction de chaîne en ligne, consultez [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options).
* Consultez le [guide des dictionnaires](/docs/react/guides/translating-with-dictionaries) pour la configuration et les conventions.