# gt-react: General Translation React SDK: DictionaryTranslationOptions
URL: https://generaltranslation.com/ru/docs/react/api/types/dictionary-translation-options.mdx
---
title: DictionaryTranslationOptions
description: Справка по API для типа DictionaryTranslationOptions
---

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


## Обзор

Тип `DictionaryTranslationOptions` используется для передачи переменных в записи словаря и задания правил их рендеринга.
Он используется вместе с [`useTranslations`](/docs/react/api/dictionary/use-translations) для передачи переменных в записи словаря.

<Callout>
  **Перевод на этапе сборки:**
  Переводы через `useTranslations` выполняются на этапе сборки, однако переменные никогда не переводятся.
  Вместо этого они подставляются в перевод с форматированием.
  Обязательно следуйте [этому руководству по развёртыванию](/docs/react/tutorials/quickdeploy).
</Callout>

## Справка

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

<TypeTable
  type={{
  "variables?": {
      type: 'Record<string, any>',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Описание

| Свойство    | Описание                                                                                  |
| ----------- | ----------------------------------------------------------------------------------------- |
| `variables` | Объект, где ключи указывают, какому месту в записи словаря соответствует каждое значение. |

***

## Примеры

### Передача переменных

Чтобы передать переменную в запись словаря, нужно сделать две вещи: (1) добавить переменную в запись и (2) сослаться на эту переменную при вызове [`d`](/docs/react/api/dictionary/use-translations).

Сначала добавьте переменную в запись словаря, используя следующий синтаксис: `{username}`.
`username` — имя переменной.

```jsx title="dictionary.ts"
// [!code word:username]
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!',
  },
};

export default dictionary;
```

Далее обращаемся к переменной:

```jsx title="Component.tsx"
// [!code word:username]
import { useTranslations } from 'gt-react';

const Component = () => {
  const t = useTranslations();
  return <div>{t('greeting.hello', { username : 'Brian123' })}</div>;
};
```


### Использование формата сообщений ICU

`gt-react` поддерживает формат сообщений ICU, который позволяет также форматировать значения переменных.

```jsx title="dictionary.ts"
// [!code word:account-balance]
const dictionary = {
  account: {
    balance: 'Баланс вашего счёта: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

Далее обращаемся к переменной:

```jsx title="Component.tsx"
// [!code word:account-balance]
import { useTranslations } from 'gt-react';

const Component = () => {
  const t = useTranslations();
  return <div>
    { t(
      'account.balance',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};
```

***


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

* Объект `variables` передаёт значения для записи словаря.
* Объект `variablesOptions` определяет поведение переменных.

## Что дальше

* См. [словари](/docs/react/guides/dictionaries), чтобы узнать больше о словарях и распространённых практиках их использования.
* См. [`useTranslations`](/docs/react/api/dictionary/use-translations), чтобы узнать больше об интерфейсе словарей.
* См. [`формат сообщений ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/), чтобы узнать больше о параметрах форматирования.