# gt-next: General Translation Next.js SDK: loadTranslations
URL: https://generaltranslation.com/it/docs/next/api/config/load-translations.mdx
---
title: loadTranslations
description: Riferimento API della funzione loadTranslations()
---

## Panoramica

Usa `loadTranslations` per specificare come caricare le traduzioni.
Per impostazione predefinita, in produzione la tua app caricherà le traduzioni dalla CDN di GT.
Puoi specificare una funzione `loadTranslations` per caricare le traduzioni da un'origine diversa, ad esempio:

* dal bundle della tua app (il caso più comune)
* da un database
* da un'API
* da una CDN diversa

Abbiamo integrato il supporto per il caricamento delle traduzioni da file locali nel bundle della tua app.
Segui [questa guida](/docs/next/guides/local-tx) per configurare le traduzioni locali nella tua app Next.js.

Se vuoi definire manualmente le traduzioni, consulta la [guida alle traduzioni personalizzate](/docs/next/concepts/stand-alone)
e la funzione [`loadDictionary`](/docs/next/api/config/load-dictionary).

## Riferimento

### Parametri

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

### Descrizione

| Tipo     | Descrizione                                                  |
| -------- | ------------------------------------------------------------ |
| `locale` | L&#39;impostazione regionale per cui caricare le traduzioni. |

### Restituisce

Un `Promise<any>` che restituisce un dizionario che associa gli ID alle traduzioni per l&#39;impostazione regionale specificata.

***

## Setup

Definisci `loadTranslations` come export predefinito di un file denominato `loadTranslations.js` o `loadTranslations.ts`, nella directory `src/` oppure nella root.
Assicurati che la funzione restituisca una promise che si risolva in un oggetto contenente le traduzioni per l&#39;impostazione regionale specificata.

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

Se vuoi usare un nome o un percorso diverso, specifica il percorso relativo tramite il parametro `loadTranslationsPath` in [`withGTConfig`](/docs/next/api/config/with-gt-config).

***


## Esempi

### Recuperare le traduzioni dal bundle

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

Quando è configurato per usare le [traduzioni locali](/docs/next/guides/local-tx), il comando [`gt translate`](/docs/cli/translate)
salverà le traduzioni nella struttura dei file del progetto.

```bash
npx gt translate
```


### Caricare le traduzioni da una 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 {};
  }
};
```


### Carica le traduzioni dal tuo database

```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>
  **Domanda:** Qual è la differenza tra [`loadTranslations`](/docs/next/api/config/load-translations) e [`loadDictionary`](/docs/next/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/next/api/config/load-translations) serve a definire un comportamento di caricamento personalizzato per recuperare le traduzioni della tua app.
    Ad esempio, le traduzioni possono essere recuperate da una CDN, da un database o dal bundle della tua app.
    In genere si tratta di traduzioni generate automaticamente, gestite dallo strumento CLI e non particolarmente comode da modificare manualmente.
  * [`loadDictionary`](/docs/next/api/config/load-dictionary) è pensato per implementazioni di `gt-next` come libreria autonoma.
    Gli utenti forniscono le proprie traduzioni e non viene utilizzata alcuna infrastruttura di traduzione.
</Callout>

***


## Note

* `loadTranslations` ti consente di personalizzare il caricamento delle traduzioni nella tua app in produzione.
* Il caso d’uso più comune è l’aggiunta di [traduzioni locali](/docs/next/guides/local-tx)

## Passaggi successivi

* Scopri perché potresti voler usare le [traduzioni locali](/docs/next/guides/local-tx)
* Aggiungi le tue traduzioni con la [guida alle traduzioni personalizzate](/docs/next/concepts/stand-alone)