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

title: loadTranslations
description: Personalizza il caricamento delle traduzioni in produzione con General Translation gt-react. Riferimento API per loadTranslations.

---

`loadTranslations` è una funzione `loader` che definisci per personalizzare l'origine da cui `gt-react` legge le traduzioni in produzione. Passala alla [chiamata di inizializzazione](/docs/react/reference/config#initialization) per caricare le traduzioni da una sorgente diversa dalla CDN predefinita di General Translation.

*Si applica a `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`, ma l'integrazione varia. `loadTranslations` è 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), mentre `gt-react-native` carica le traduzioni tramite la configurazione del proprio provider. Il contratto del loader descritto in questa pagina è lo stesso ovunque.*

## Panoramica [#overview]

Definisci una funzione che accetti un'impostazione regionale e ne restituisca le traduzioni, quindi passala come opzione `loadTranslations` a [`initializeGT`](/docs/react/reference/config#initialize). Nelle applicazioni a pagina singola, invece, va passata a [`initializeGTSPA`](/docs/react/reference/config#initialize-spa).

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

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

*Nota: in `gt-react`, `loadTranslations` è un&#39;opzione di configurazione nella chiamata di inizializzazione, non una prop di [`<GTProvider>`](/docs/react/reference/components/gt-provider). Per impostazione predefinita, le traduzioni vengono caricate dal CDN di General Translation.*

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

In produzione, le tue traduzioni devono essere memorizzate in una posizione da cui possano essere lette in fase di esecuzione. Per impostazione predefinita provengono dalla CDN di General Translation. Passa `loadTranslations` per caricarle da un&#39;altra sorgente, ad esempio:

* Il bundle della tua app (il caso più comune).
* Un database.
* Un&#39;API.
* Una CDN diversa.

`gt-react` supporta nativamente il caricamento delle traduzioni da file locali nel bundle. Vedi [Memorizzare le traduzioni localmente](/docs/react/guides/storing-translations).

## Parametri [#parameters]

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

### `locale` [#locale]

**Tipo** `stringa` · **Obbligatorio**

L&#39;impostazione regionale per la quale devono essere caricate le traduzioni.

## Restituisce [#returns]

**Tipo** `Promise<unknown>`

Una promise che si risolve con le traduzioni per l&#39;impostazione regionale specificata.

## Esempi [#examples]

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

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const response = await fetch(`https://your-cdn.com/translations/${locale}.json`);
    return await response.json();
  } catch (e) {
    console.error(e);
    return {};
  }
}
```

## Note [#notes]

* `loadTranslations` personalizza il modo in cui le traduzioni vengono caricate in produzione; il suo caso d’uso più comune è quello delle [traduzioni locali](/docs/react/guides/storing-translations).
* Per usare invece traduzioni scritte da persone e gestite autonomamente come libreria i18n standalone, usa [`loadDictionary`](/docs/react/reference/functions/load-dictionary).