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

## Panoramica

`loadDictionary` carica un file JSON di traduzione per una determinata impostazione regionale.

Questa funzione è pensata per chi desidera usare `gt-next` come libreria i18n autonoma.

Questa funzione viene usata principalmente per migrare progetti i18n esistenti a General Translation mantenendo le traduzioni già presenti.
Segui [questa guida](/docs/next/guides/migration) per configurare il tutto.

Se esistono più traduzioni, quelle dei dizionari caricati con `loadDictionary` avranno sempre la precedenza sulle altre.
`loadDictionary` supporta solo file JSON contenenti traduzioni di stringhe.

## Riferimento

### Parametri

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

### Descrizione

| Tipo     | Descrizione                                                                     |
| -------- | ------------------------------------------------------------------------------- |
| `locale` | L&#39;impostazione regionale per la quale devono essere caricate le traduzioni. |

### Restituisce

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

***

## Setup

In generale, il dizionario viene caricato dalla directory `./public/locales`.

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

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

<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.
    Può trattarsi, ad esempio, di recuperarle da una CDN, da un database o dal bundle della tua app.
    In genere sono traduzioni generate automaticamente, gestite dallo strumento CLI, e non particolarmente pratiche 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

* `loadDictionary` viene usato per caricare traduzioni personalizzate per la tua app.
* I dizionari caricati tramite `loadDictionary` hanno la precedenza sulle traduzioni caricate con [`loadTranslations`](/docs/next/api/config/load-translations).

## Prossimi passi

* Se vuoi scrivere le tue traduzioni, consulta [traduzioni personalizzate](/docs/next/concepts/stand-alone).
* Vedi [`loadTranslations`](/docs/next/api/config/load-translations) per ulteriori informazioni su come scrivere un loader di traduzioni personalizzato.