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

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


## Vue d’ensemble

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

Cette fonction est destinée à celles et ceux qui souhaitent utiliser `gt-react-native` comme bibliothèque d’i18n autonome.

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

Si plusieurs traductions existent, celles issues 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 se résout en un dictionnaire associant les `id` aux traductions du paramètre régional donné.

***

## 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 indiqué.

```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-native';
import loadDictionary from './loadDictionary';

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

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

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

***


## Remarques

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

## Étapes suivantes

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