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

## Vue d’ensemble

Utilisez `loadTranslations` pour définir le mode de chargement des traductions.
Par défaut, en production, votre application charge les traductions depuis le CDN de GT.
Vous pouvez définir une fonction `loadTranslations` pour charger les traductions depuis une autre source, par exemple :

* Depuis le bundle de votre application (le plus courant)
* Depuis une base de données
* Depuis une API
* Depuis un autre CDN

La prise en charge du chargement des traductions à partir de fichiers locaux inclus dans le bundle de votre application est intégrée.
Suivez [ce guide](/docs/next/guides/local-tx) pour configurer des traductions locales dans votre application Next.js.

Si vous souhaitez définir manuellement vos propres traductions, consultez le [guide des traductions personnalisées](/docs/next/concepts/stand-alone)
et la fonction [`loadDictionary`](/docs/next/api/config/load-dictionary).

## Référence

### Paramètres

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

### Description

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

### Renvoie

Une `Promise<any>` qui renvoie un dictionnaire associant les identifiants aux traductions pour le paramètre régional donné.

***

## Setup

Définissez `loadTranslations` comme export par défaut d’un fichier nommé `loadTranslations.js` ou `loadTranslations.ts`, placé soit dans le répertoire `src/`, soit à la racine.
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é.

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

Si vous souhaitez utiliser un autre nom ou chemin, indiquez le chemin relatif via le paramètre `loadTranslationsPath` dans [`withGTConfig`](/docs/next/api/config/with-gt-config).

***


## Exemples

### Récupérer les traductions à partir de votre bundle

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

Lorsqu’elle est configurée pour utiliser des [traductions locales](/docs/next/guides/local-tx), la commande [`gt translate`](/docs/cli/translate)
enregistre les traductions dans l’arborescence des fichiers de votre projet.

```bash
npx gt translate
```


### Charger les traductions depuis un CDN

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


### Charger les traductions depuis votre propre base de données

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const translations = await prisma.translation.findUnique({
      where: {
        locale: locale,
      },
    });
    return translations;
  } catch (e) {
    console.error(e);
    return {};
  }
};
```

<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 récupérer 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/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 et aucune infrastructure de traduction n’est utilisée.
</Callout>

***


## Remarques

* `loadTranslations` vous permet de personnaliser le chargement des traductions dans votre application en production.
* Son cas d’usage le plus courant est d’ajouter des [traductions locales](/docs/next/guides/local-tx)

## Étapes suivantes

* Découvrez pourquoi vous pourriez vouloir utiliser les [traductions locales](/docs/next/guides/local-tx)
* Ajoutez vos propres traductions avec le [guide des traductions personnalisées](/docs/next/concepts/stand-alone)