# react-native: loadDictionary
URL: https://generaltranslation.com/ru/docs/react-native/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Справка по API-функции loadDictionary()
---

{/* СГЕНЕРИРОВАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого редактируйте template в content/docs-templates/. */}


## Обзор

`loadDictionary` загружает JSON-файл с переводами для заданной локали.

Эта функция предназначена для тех, кто хочет использовать `gt-react-native` как автономную библиотеку i18n.

Эта функция в первую очередь используется для миграции существующих проектов с i18n на General Translation с сохранением имеющихся переводов.

Если доступно несколько вариантов перевода, переводы из словарей, загруженных через `loadDictionary`, всегда будут иметь приоритет над остальными.
`loadDictionary` поддерживает только JSON-файлы с переводами в виде строковых значений.

## Справка

### Параметры

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

### Описание

| Тип      | Описание                                      |
| -------- | --------------------------------------------- |
| `locale` | Локаль, для которой нужно загрузить переводы. |

### Возвращает

`Promise<any>`, который возвращает словарь, сопоставляющий id с переводами для указанной локали.

***

## Сетап

Обычно словарь загружают из каталога `./public/locales`.

Определите `loadDictionary` в файле.
Убедитесь, что функция возвращает promise, который резолвится в объект с переводами для указанной локали.

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

Затем передайте его компоненту `<GTProvider>`:

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

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

<Callout>
  **Вопрос:** В чем разница между [`loadTranslations`](/docs/react-native/api/config/load-translations) и [`loadDictionary`](/docs/react-native/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/react-native/api/config/load-translations) используется для настройки пользовательской логики загрузки переводов для вашего приложения.
    Например, переводы можно загружать из CDN, базы данных или из бандла приложения.
    Обычно это машинно сгенерированные переводы, которыми управляет CLI, и редактировать их вручную не очень удобно.
  * [`loadDictionary`](/docs/react-native/api/config/load-dictionary) предназначен для использования `gt-react-native` как автономной библиотеки.
    Пользователи предоставляют собственные переводы, и никакая инфраструктура перевода не используется.
</Callout>

***


## Примечания

* `loadDictionary` используется для загрузки пользовательских переводов в ваше приложение.
* Словари, загруженные через `loadDictionary`, имеют приоритет над переводами, загруженными через [`loadTranslations`](/docs/react-native/api/config/load-translations).

## Что дальше

* Если вы хотите писать собственные переводы, ознакомьтесь с разделом [пользовательские переводы](/docs/react-native/concepts/stand-alone).
* Дополнительные сведения о создании собственного загрузчика переводов см. в [`loadTranslations`](/docs/react-native/api/config/load-translations).