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

## Vue d’ensemble

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

Cette fonction est destinée à ceux qui souhaitent utiliser `gt-next` comme bibliothèque i18n autonome.

Cette fonction sert principalement à migrer des projets i18n existants vers General Translation tout en conservant leurs traductions actuelles.
Suivez [ce guide](/docs/next/guides/migration) pour mettre cela en place.

Si plusieurs traductions sont disponibles, celles provenant des dictionnaires chargés par `loadDictionary` auront toujours priorité sur les autres.
`loadDictionary` ne prend en charge que 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 `id` aux traductions pour le paramètre régional donné.

***

## Configuration

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

Définissez `loadDictionary` comme export par défaut d’un fichier nommé `loadDictionary.js` ou `loadDictionary.ts`, placé soit dans le répertoire `src/`, soit à la racine.
Assurez-vous que la fonction renvoie une promesse qui aboutit à un objet contenant les traductions pour le paramètre régional indiqué.

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

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

  * [`loadTranslations`](/docs/next/api/config/load-translations) sert à définir un comportement de chargement personnalisé pour récupérer les traductions de votre application.
    Il peut s’agir de les charger 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/next/api/config/load-dictionary) est destiné aux implémentations de `gt-next` en tant que bibliothèque autonome.
    Les utilisateurs fournissent leurs propres traductions, sans recourir à une infrastructure de traduction.
</Callout>

***


## Remarques

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

## Étapes suivantes

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