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

title: loadTranslations
description: Personnalisez le chargement des traductions en production avec General Translation gt-react. Référence de l’API pour loadTranslations.

---

`loadTranslations` est une fonction `loader` que vous définissez pour personnaliser l’emplacement depuis lequel `gt-react` lit les traductions en production. Passez-la à l’[appel d’initialisation](/docs/react/reference/config#initialization) pour charger les traductions depuis une source autre que le CDN de General Translation par défaut.

*S’applique à `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`, mais l’intégration diffère. `loadTranslations` est un `loader` que vous définissez, pas 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), et `gt-react-native` charge les traductions via la configuration de son provider. Le contrat du loader présenté 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 les traductions correspondantes, puis passez-la comme option `loadTranslations` à [`initializeGT`](/docs/react/reference/config#initialize). Les applications monopage la passent plutôt à [`initializeGTSPA`](/docs/react/reference/config#initialize-spa).

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

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

*Remarque : dans `gt-react`, `loadTranslations` est une option de configuration de l’appel d’initialisation, et non une prop de [`<GTProvider>`](/docs/react/reference/components/gt-provider). Par défaut, les traductions sont chargées depuis le CDN de General Translation.*

## Comment ça marche [#how-it-works]

En production, vos traductions doivent être stockées à un endroit où elles sont accessibles à l’exécution. Par défaut, elles proviennent du CDN de General Translation. Fournissez `loadTranslations` pour les charger depuis une autre source, par exemple :

* Le bundle de votre application (le cas le plus courant).
* Une base de données.
* Une API.
* Un autre CDN.

`gt-react` prend en charge nativement le chargement des traductions depuis des fichiers locaux dans le bundle de votre application. Consultez [Stocker les traductions localement](/docs/react/guides/storing-translations).

## Paramètres [#parameters]

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

### `locale` [#locale]

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

Le paramètre régional pour lequel charger les traductions.

## Renvoie [#returns]

**Type** `Promise<unknown>`

Une promesse qui se résout avec les traductions du paramètre régional donné.

## Exemples [#examples]

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

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const response = await fetch(`https://your-cdn.com/translations/${locale}.json`);
    return await response.json();
  } catch (e) {
    console.error(e);
    return {};
  }
}
```

## Notes [#notes]

* `loadTranslations` personnalise le chargement des traductions en production ; son cas d’usage le plus courant est celui des [traductions locales](/docs/react/guides/storing-translations).
* Si vous souhaitez utiliser vos propres traductions rédigées par des humains avec une bibliothèque d’i18n autonome, utilisez plutôt [`loadDictionary`](/docs/react/reference/functions/load-dictionary).