# react-native: loadDictionary
URL: https://generaltranslation.com/it/docs/react-native/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Riferimento dell'API per la funzione loadDictionary()
---

{/* GENERATO AUTOMATICAMENTE: Non modificare direttamente. Modifica il modello 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-native` come libreria i18n autonoma.

Questa funzione viene usata principalmente per migrare a General Translation progetti esistenti con i18n, mantenendone le traduzioni esistenti.

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

## Riferimento

### Parametri

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

### Descrizione

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

### Restituisce

Una `Promise<any>` che restituisce un dizionario che mappa 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 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;
}
```

Quindi passalo al componente `<GTProvider>`:

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

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

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

  * [`loadTranslations`](/docs/react-native/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 dell&#39;app.
    In genere si tratta di traduzioni generate automaticamente, gestite dallo strumento CLI e non particolarmente facili da modificare.
  * [`loadDictionary`](/docs/react-native/api/config/load-dictionary) è pensato per le implementazioni di `gt-react-native` come libreria autonoma.
    Gli utenti forniscono le proprie traduzioni e non viene utilizzata alcuna infrastruttura di traduzione.
</Callout>

***


## Note

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

## Passaggi successivi

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