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

title: loadDictionary
description: Carga tus propias traducciones de diccionario como una biblioteca de i18n independiente con General Translation gt-react. Referencia de la API para loadDictionary.

---

`loadDictionary` es una función de carga que defines para cargar un diccionario de traducciones para una configuración regional. Está pensada para usar `gt-react` como una biblioteca de i18n independiente, es decir, para aportar tus propias traducciones, normalmente al migrar un proyecto de i18n existente a General Translation.

*Se aplica a `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`, pero la integración varía. `loadDictionary` es una función de carga que defines, no un símbolo exportado. En `gt-react` y `gt-tanstack-start`, pásala a la llamada de inicialización (más abajo); `gt-next` la resuelve mediante el plugin `withGTConfig` (documentado en la sección de Next.js). El contrato de la función de carga en esta página es el mismo en todos los casos.*

## Resumen general [#overview]

Define una función que reciba una configuración regional y devuelva su diccionario, y luego pásala como opción `loadDictionary` a [`initializeGT`](/docs/react/reference/config#initialize). En las aplicaciones de una sola página, pásala a [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) en su lugar.

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

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

*Nota: en `gt-react`, `loadDictionary` es una opción de configuración en la llamada de inicialización, no una prop de [`<GTProvider>`](/docs/react/reference/components/gt-provider). `loadDictionary` solo admite archivos JSON con traducciones de cadenas.*

## Cómo funciona [#how-it-works]

* **Traducciones independientes.** `loadDictionary` carga un archivo JSON de traducción para una configuración regional específica. Úsalo cuando usas tus propias traducciones y no dependes de la infraestructura de traducción de General Translation.
* **Precedencia.** Cuando existen varias traducciones, los diccionarios cargados con `loadDictionary` siempre tienen prioridad sobre las traducciones cargadas con [`loadTranslations`](/docs/react/reference/functions/load-translations).
* **Solo JSON.** Solo admite archivos JSON que contengan traducciones de cadenas.

*La diferencia entre las dos funciones de carga: [`loadTranslations`](/docs/react/reference/functions/load-translations) permite personalizar la obtención de traducciones generadas por máquina gestionadas por la CLI (desde una CDN, una base de datos o un bundle), mientras que `loadDictionary` sirve para implementar `gt-react` como una biblioteca independiente con tus propias traducciones y sin infraestructura de traducción.*

## Parámetros [#parameters]

| Parámetro           | Descripción                                                             | Tipo     | Opcional | Predeterminado |
| ------------------- | ----------------------------------------------------------------------- | -------- | -------- | -------------- |
| [`locale`](#locale) | La configuración regional para la que se deben cargar las traducciones. | `string` | No       | —              |

### `locale` [#locale]

**Tipo** `string` · **Obligatorio**

La configuración regional cuyo diccionario se debe cargar.

## Devuelve [#returns]

**Tipo** `Promise<Dictionary>`

Una promesa que se resuelve en un `Dictionary` que relaciona ids con traducciones para la configuración regional especificada.

## Ejemplos [#examples]

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

## Notas [#notes]

* `loadDictionary` carga tus propias traducciones para usarlas de forma independiente y tiene prioridad sobre [`loadTranslations`](/docs/react/reference/functions/load-translations).
* Solo admite archivos JSON con traducción de cadenas.
* Resuelve las entradas del diccionario en Runtime con [`useTranslations`](/docs/react/reference/hooks/use-translations).