# gt-react: General Translation React SDK: loadDictionary
URL: https://generaltranslation.com/it/docs/react/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Riferimento API per la funzione loadDictionary()
---

{/* GENERATO AUTOMATICAMENTE: Non modificare direttamente. Modifica invece il template in content/docs-templates/. */}


## Panoramica

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

Questa funzione è pensata per chi desidera usare `gt-react` come libreria i18n indipendente.

Questa funzione viene usata principalmente per migrare progetti esistenti con i18n a General Translation mantenendo le traduzioni già presenti.

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

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

### Valore restituito

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

***

## Setup

In genere, caricherai il dizionario dalla directory `./public/locales`.

Definisci `loadDictionary` in un file.
Assicurati che la funzione restituisca una promise che si risolve in un oggetto con le traduzioni per l&#39;impostazione regionale indicata.

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

Quindi passalo al componente `<GTProvider>`:

```jsx title="src/App.js"
import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';

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

<Callout>
  **Domanda:** Qual è la differenza tra [`loadTranslations`](/docs/react/api/config/load-translations) e [`loadDictionary`](/docs/react/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/react/api/config/load-translations) serve a definire una logica di caricamento personalizzata per recuperare le traduzioni della tua app.
    Ad esempio, puoi caricare le traduzioni 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 semplici da modificare manualmente.
  * [`loadDictionary`](/docs/react/api/config/load-dictionary) è pensato per implementazioni di `gt-react` come libreria autonoma.
    Gli utenti forniscono le proprie traduzioni e non viene utilizzata alcuna infrastruttura di traduzione.
</Callout>

***


## Note

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

## Passaggi successivi

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