# gt-react: General Translation React SDK: loadDictionary
URL: https://generaltranslation.com/fr/docs/react/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Référence API de la fonction loadDictionary()
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas ce fichier directement. Modifiez plutôt le modèle dans content/docs-templates/. */}


## Vue d’ensemble

`loadDictionary` charge un fichier JSON de traduction pour un paramètre régional donné.

Cette fonction s’adresse à celles et ceux qui souhaitent utiliser `gt-react` comme bibliothèque i18n autonome.

Cette fonction est principalement utilisée pour migrer des projets i18n existants vers General Translation tout en conservant leurs traductions actuelles.

Si plusieurs traductions existent, celles issues des dictionnaires chargés via `loadDictionary` ont toujours priorité sur les autres.
`loadDictionary` prend uniquement en charge les fichiers JSON contenant des traductions sous forme de chaînes de caractères.

## Référence

### Paramètres

<TypeTable
  type={{
  "locale": {
      type: 'string',
      optional: false,
  },
}}
/>

### Description

| Type     | Description                                                       |
| -------- | ----------------------------------------------------------------- |
| `locale` | Le paramètre régional dont les traductions doivent être chargées. |

### Renvoie

Une `Promise<any>` qui renvoie un dictionnaire associant des identifiants à des traductions pour le paramètre régional spécifié.

***

## Configuration

En général, vous chargerez le dictionnaire depuis le répertoire `./public/locales`.

Définissez `loadDictionary` dans un fichier.
Assurez-vous que la fonction renvoie une promesse qui se résout en un objet contenant les traductions pour le paramètre régional spécifié.

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

Transmettez-le ensuite à votre composant `<GTProvider>` :

```jsx title="src/App.js"
import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';

<GTProvider loadDictionary={loadDictionary}>
  <App />
</GTProvider>
```

<Callout>
  **Question :** Quelle est la différence entre [`loadTranslations`](/docs/react/api/config/load-translations) et [`loadDictionary`](/docs/react/api/config/load-dictionary) ?

  * [`loadTranslations`](/docs/react/api/config/load-translations) sert à définir un comportement de chargement personnalisé pour récupérer les traductions de votre application.
    Cela peut consister à charger les traductions depuis un CDN, une base de données ou le bundle de votre application.
    Il s’agit généralement de traductions générées automatiquement, gérées par l’outil CLI, et peu pratiques à modifier manuellement.
  * [`loadDictionary`](/docs/react/api/config/load-dictionary) est destiné aux implémentations de `gt-react` comme bibliothèque autonome.
    Les utilisateurs fournissent leurs propres traductions et aucune infrastructure de traduction n’est utilisée.
</Callout>

***


## Remarques

* `loadDictionary` sert à charger des traductions personnalisées pour votre application.
* Les dictionnaires chargés par `loadDictionary` sont prioritaires sur les traductions chargées par [`loadTranslations`](/docs/react/api/config/load-translations).

## Étapes suivantes

* Si vous souhaitez rédiger vos propres traductions, consultez [traductions personnalisées](/docs/react/concepts/stand-alone).
* Consultez [`loadTranslations`](/docs/react/api/config/load-translations) pour en savoir plus sur la création d’un chargeur de traductions personnalisé.