# 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 para la función loadDictionary()
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, edita la plantilla en content/docs-templates/. */}


## Resumen

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

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 existentes.

Si existen varias traducciones, las traducciones de los diccionarios cargados por `loadDictionary` siempre tendrán prioridad sobre las demás.
`loadDictionary` solo admite el uso de 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 cuyas traducciones deben cargarse. |

### Devuelve

Una `Promise<any>` que se resuelve como un diccionario que asigna los ID a las traducciones para la configuración regional especificada.

***

## Configuración

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 resuelva a un objeto con traducciones para la configuración regional especificada.

```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 al 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 traducciones para tu aplicación.
    Esto puede incluir obtener traducciones desde una CDN, una base de datos o el bundle de tu aplicación.
    Normalmente, son traducciones generadas automáticamente, gestionadas por la herramienta CLI, y no son especialmente fáciles de editar.
  * [`loadDictionary`](/docs/react/api/config/load-dictionary) está pensado para implementaciones de `gt-react` como una biblioteca independiente.
    Los usuarios aportan sus propias traducciones y no se utiliza ninguna infraestructura de traducción.
</Callout>

***


## Notas

* `loadDictionary` se utiliza para cargar traducciones personalizadas para tu aplicación.
* Los diccionarios cargados mediante `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).
* Para obtener más información sobre cómo crear un cargador de traducciones personalizado, consulta [`loadTranslations`](/docs/react/api/config/load-translations).