# gt-react: General Translation React SDK: loadDictionary
URL: https://generaltranslation.com/ru/docs/react/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Справка по API для функции loadDictionary()
---

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


## Обзор

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

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

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

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

## Справочник

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

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

### Описание

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

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

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

***

## Настройка

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

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

```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';
import loadDictionary from './loadDictionary';

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

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

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

***


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

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

## Что дальше

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