# gt-react: General Translation React SDK: loadDictionary
URL: https://generaltranslation.com/es/docs/react/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Referencia de la API de la función loadDictionary()
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}


## Descripción general

`loadDictionary` carga un archivo JSON de traducción para una configuración regional determinada.

Esta función está pensada para quienes desean usar `gt-react` como una biblioteca de i18n independiente.

Esta función se usa principalmente para migrar proyectos existentes con i18n a General Translation sin dejar de conservar sus traducciones actuales.

Si existen varias traducciones, las de los diccionarios cargados con `loadDictionary` siempre tendrán prioridad sobre las demás.
`loadDictionary` solo admite archivos JSON con traducciones de cadenas.

## Referencia

### Parámetros

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

### Descripción

| Tipo     | Descripción                                                            |
| -------- | ---------------------------------------------------------------------- |
| `locale` | La configuración regional para la que deben cargarse las traducciones. |

### Devuelve

Una `Promise<any>` que se resuelve en un diccionario que asigna IDs a traducciones para la configuración regional especificada.

***

## Setup

Por lo general, cargarás el diccionario desde el directorio `./public/locales`.

Define `loadDictionary` en un archivo.
Asegúrate de que la función devuelva una promesa que se resuelva en un objeto con traducciones para la configuración regional indicada.

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

Luego, pásalo a tu componente `<GTProvider>`:

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

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

<Callout>
  **Pregunta:** ¿Cuál es la diferencia entre [`loadTranslations`](/docs/react/api/config/load-translations) y [`loadDictionary`](/docs/react/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/react/api/config/load-translations) se usa para definir un comportamiento de carga personalizado para obtener las traducciones de tu aplicación.
    Esto puede implicar cargarlas desde una CDN, una base de datos o el paquete de tu aplicación.
    Normalmente, son traducciones generadas automáticamente, gestionadas por la herramienta CLI, y no resultan muy fáciles de editar.
  * [`loadDictionary`](/docs/react/api/config/load-dictionary) está pensado para implementaciones de `gt-react` como biblioteca autónoma.
    Los usuarios aportan sus propias traducciones y no se utiliza ninguna infraestructura de traducción.
</Callout>

***


## Notas

* `loadDictionary` se usa para cargar traducciones personalizadas en tu aplicación.
* Los diccionarios cargados con `loadDictionary` tendrán prioridad sobre las traducciones cargadas mediante [`loadTranslations`](/docs/react/api/config/load-translations).

## Próximos pasos

* Si quieres escribir tus propias traducciones, consulta [traducciones personalizadas](/docs/react/concepts/stand-alone).
* Consulta [`loadTranslations`](/docs/react/api/config/load-translations) para obtener más información sobre cómo crear un cargador de traducciones personalizado.