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

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


## Resumen

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

Esta función está pensada para quienes quieran usar `gt-react-native` 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 cuyas traducciones se deben cargar. |

### Devuelve

Una `Promise<any>` que se resuelve en un diccionario que asigna los ids a las traducciones de la configuración regional indicada.

***

## 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 las traducciones de 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-native';
import loadDictionary from './loadDictionary';

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

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

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

***


## Notas

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

## Siguientes pasos

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