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

title: loadDictionary
description: Carica le traduzioni del tuo dizionario come libreria i18n autonoma con General Translation gt-react. Riferimento API per loadDictionary.

---

`loadDictionary` è una funzione loader che definisci per caricare un dizionario di traduzioni per un'impostazione regionale. È pensata per usare `gt-react` come libreria i18n autonoma, cioè per usare le tue traduzioni, in genere durante la migrazione di un progetto i18n esistente a General Translation.

*Si applica a `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`, ma l'integrazione varia. `loadDictionary` è un loader che definisci tu, non un simbolo esportato. In `gt-react` e `gt-tanstack-start`, passalo alla chiamata di inizializzazione (qui sotto); `gt-next` lo risolve tramite il plugin `withGTConfig` (documentato nella sezione Next.js). Il contratto del loader descritto in questa pagina è lo stesso ovunque.*

## Panoramica [#overview]

Definisci una funzione che accetti un'impostazione regionale e ne restituisca il dizionario, quindi passala come opzione `loadDictionary` a [`initializeGT`](/docs/react/reference/config#initialize). Le app a pagina singola la passano invece a [`initializeGTSPA`](/docs/react/reference/config#initialize-spa).

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

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

*Nota: in `gt-react`, `loadDictionary` è un&#39;opzione di configurazione nella chiamata di inizializzazione, non una prop di [`<GTProvider>`](/docs/react/reference/components/gt-provider). `loadDictionary` supporta solo file JSON con traduzioni di stringhe.*

## Come funziona [#how-it-works]

* **Traduzioni autonome.** `loadDictionary` carica un file JSON di traduzione per una determinata impostazione regionale. Usalo quando gestisci direttamente le tue traduzioni e non ti affidi all&#39;infrastruttura di traduzione di General Translation.
* **Precedenza.** Quando esistono più traduzioni, i dizionari caricati da `loadDictionary` hanno sempre la precedenza rispetto alle traduzioni caricate da [`loadTranslations`](/docs/react/reference/functions/load-translations).
* **Solo JSON.** Supporta solo file JSON contenenti traduzioni di stringhe.

*La differenza tra i due loader: [`loadTranslations`](/docs/react/reference/functions/load-translations) consente di personalizzare il recupero delle traduzioni generate automaticamente e gestite dalla CLI (da una CDN, un database o un bundle), mentre `loadDictionary` serve a implementare `gt-react` come libreria autonoma con le tue traduzioni e senza alcuna infrastruttura di traduzione.*

## Parametri [#parameters]

| Parametro           | Descrizione                                                  | Tipo     | Facoltativo | Predefinito |
| ------------------- | ------------------------------------------------------------ | -------- | ----------- | ----------- |
| [`locale`](#locale) | L&#39;impostazione regionale per cui caricare le traduzioni. | `string` | No          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

L&#39;impostazione regionale per la quale deve essere caricato il dizionario.

## Restituisce [#returns]

**Tipo** `Promise<Dictionary>`

Una promise che restituisce una mappatura `Dictionary` degli id alle traduzioni per l&#39;impostazione regionale specificata.

## Esempi [#examples]

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

## Note [#notes]

* `loadDictionary` carica le tue traduzioni per l&#39;uso autonomo e ha la precedenza su [`loadTranslations`](/docs/react/reference/functions/load-translations).
* Supporta solo file JSON con traduzioni di stringhe.
* Risolvi le voci del dizionario a Runtime con [`useTranslations`](/docs/react/reference/hooks/use-translations).