# General Translation React SDKs (gt-react, gt-next): DictionaryTranslationOptions
URL: https://generaltranslation.com/ru/docs/react/reference/types/dictionary-translation-options.mdx
---

title: DictionaryTranslationOptions
description: Параметры для передачи переменных в записи словаря в General Translation gt-react. Справочник API для DictionaryTranslationOptions.

---

`DictionaryTranslationOptions` — это объект параметров для поиска в словаре. Он содержит переменные интерполяции, которые подставляются в запись словаря. Его принимает функция, возвращаемая из [`useTranslations`](/docs/react/reference/hooks/use-translations).

*Эти параметры применяются везде, где доступен [`useTranslations`](/docs/react/reference/hooks/use-translations): `gt-react`, `gt-next`, `gt-tanstack-start` и `gt-react-native`.*

## Обзор [#overview]

Передавайте переменные интерполяции в виде обычных ключей. Каждый ключ соответствует плейсхолдеру `{name}` в записи словаря.

```typescript
type DictionaryTranslationOptions = {
  [variable: string]: unknown; // переменные интерполяции
};
```

*Примечание: в `gt-react` v11 аргумент `options` для `useTranslations` типизирован как `TranslationVariables` (`Record<string, unknown>`); `DictionaryTranslationOptions` — справочное название этой структуры. Переменные подставляются в перевод с форматированием, но сами по себе никогда не переводятся.*

## Свойства [#properties]

| Свойство                  | Описание                                                                           | Тип                       |
| ------------------------- | ---------------------------------------------------------------------------------- | ------------------------- |
| [`variables`](#variables) | Значения интерполяции, где ключом служит имя плейсхолдера, используемого в записи. | `Record<string, unknown>` |

### `variables` [#variables]

**Тип** `Record<string, unknown>`

Каждый ключ указывает, в какое место записи словаря подставляется его значение. Чтобы обратиться к переменной в записи словаря, используйте синтаксис `{name}`; её значение подставляется в переведённую строку без перевода. Значения можно форматировать с помощью [ICU message format](https://unicode-org.github.io/icu/userguide/format_parse/messages/).

## Примеры [#examples]

```tsx title="dictionary.ts"
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!', // {username} — переменная интерполяции
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

const Component = () => {
  const t = useTranslations();
  // Передайте { username }, чтобы заполнить плейсхолдер {username}
  return <div>{t('greeting.hello', { username: 'Brian123' })}</div>;
};
```

```tsx title="dictionary.ts"
const dictionary = {
  account: {
    // ICU message format форматирует переменную как Currency
    balance: 'Your account balance: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

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

## Заметки [#notes]

* `DictionaryTranslationOptions` используется с [`useTranslations`](/docs/react/reference/hooks/use-translations) для передачи переменных записям словаря.
* Для встроенного перевода строк см. [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options).
* О настройке и соглашениях см. [руководство по словарям](/docs/react/guides/translating-with-dictionaries).