# General Translation React SDKs (gt-react, gt-next): loadDictionary
URL: https://generaltranslation.com/fr/docs/react/reference/functions/load-dictionary.mdx
---

title: loadDictionary
description: Chargez vos propres traductions sous forme de dictionnaire avec General Translation gt-react comme bibliothèque i18n autonome. Référence de l’API de loadDictionary.

---

`loadDictionary` est une fonction loader que vous définissez pour charger un dictionnaire de traductions pour un paramètre régional. Elle sert à utiliser `gt-react` comme bibliothèque i18n autonome — afin d’apporter vos propres traductions, généralement lors de la migration d’un projet i18n existant vers General Translation.

*S’applique à `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`, mais l’intégration diffère. `loadDictionary` est un loader que vous définissez, et non un symbole exporté. Dans `gt-react` et `gt-tanstack-start`, passez-le à l’appel d’initialisation (ci-dessous) ; `gt-next` le résout via le plugin `withGTConfig` (documenté dans la section Next.js). Le contrat du loader décrit sur cette page est le même partout.*

## Vue d’ensemble [#overview]

Définissez une fonction qui prend un paramètre régional et renvoie le dictionnaire correspondant, puis passez-la à [`initializeGT`](/docs/react/reference/config#initialize) via l’option `loadDictionary`. Les applications monopage la passent plutôt à [`initializeGTSPA`](/docs/react/reference/config#initialize-spa).

```tsx
const loadDictionary = (locale: string) =>
  import(`../public/locales/${locale}.json`).then((m) => m.default);

initializeGT({ ...gtConfig, loadDictionary });
```

*Remarque : dans `gt-react`, `loadDictionary` est une option de configuration de l’appel d’initialisation, et non une prop de [`<GTProvider>`](/docs/react/reference/components/gt-provider). `loadDictionary` ne prend en charge que les fichiers JSON contenant des traductions de chaînes de caractères.*

## Fonctionnement [#how-it-works]

* **Traductions autonomes.** `loadDictionary` charge un fichier JSON de traduction pour un paramètre régional donné. Utilisez-le si vous fournissez vos propres traductions et ne dépendez pas de l&#39;infrastructure de traduction de General Translation.
* **Priorité.** Lorsque plusieurs traductions existent, les dictionnaires chargés par `loadDictionary` priment toujours sur les traductions chargées par [`loadTranslations`](/docs/react/reference/functions/load-translations).
* **JSON uniquement.** Il prend uniquement en charge les fichiers JSON contenant des traductions de chaînes de caractères.

*Différence entre les deux loaders : [`loadTranslations`](/docs/react/reference/functions/load-translations) personnalise la récupération des traductions générées automatiquement et gérées par la CLI (depuis un CDN, une base de données ou un bundle), tandis que `loadDictionary` sert à utiliser `gt-react` comme bibliothèque autonome, avec vos propres traductions et sans infrastructure de traduction.*

## Paramètres [#parameters]

| Paramètre           | Description                                                | Type     | Facultatif | Par défaut |
| ------------------- | ---------------------------------------------------------- | -------- | ---------- | ---------- |
| [`locale`](#locale) | Le paramètre régional pour lequel charger les traductions. | `string` | Non        | —          |

### `locale` [#locale]

**Type** `string` · **Obligatoire**

Paramètre régional pour lequel le dictionnaire doit être chargé.

## Renvoie [#returns]

**Type** `Promise<Dictionary>`

Une promesse renvoyant un `Dictionary` qui associe des id aux traductions du paramètre régional donné.

## Exemples [#examples]

```js title="loadDictionary.js"
export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}
```

## Notes [#notes]

* `loadDictionary` charge vos propres traductions pour une utilisation autonome et est prioritaire sur [`loadTranslations`](/docs/react/reference/functions/load-translations).
* Il ne prend en charge que les fichiers JSON contenant des traductions sous forme de chaînes de caractères.
* Résolvez les entrées du dictionnaire au moment de l’exécution avec [`useTranslations`](/docs/react/reference/hooks/use-translations).