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

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

---

`InlineTranslationOptions` — это объект параметров для встроенного перевода строк. Он содержит переменные интерполяции, а также метаданные, такие как context и идентификатор. Этот объект используется в [`useGT`](/docs/react/reference/hooks/use-gt) и [`msg`](/docs/react/reference/functions/msg).

*Эти параметры применяются везде, где доступны [`useGT`](/docs/react/reference/hooks/use-gt) и [`msg`](/docs/react/reference/functions/msg): в `gt-react`, `gt-next`, `gt-tanstack-start` и `gt-react-native`. Именованный тип `GTTranslationOptions` экспортируется из `gt-react`, `gt-next` и `gt-react-native`; `gt-tanstack-start` повторно экспортирует функции, но не сам тип.*

## Обзор [#overview]

Передавайте переменные интерполяции как обычные ключи, а метаданные перевода — в ключах с префиксом `$`.

```typescript
type InlineTranslationOptions = {
  [variable: string]: unknown; // переменные интерполяции
  $context?: string;
  $id?: string;
  $format?: string;
  $locale?: string;
  $maxChars?: number;
  $requiresReview?: boolean;
};
```

*Примечание: в `gt-react` v11 этот объект параметров экспортируется как тип `GTTranslationOptions`. Переменные подставляются в перевод, но сами никогда не переводятся.*

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

| Свойство                              | Описание                                                 | Тип                       |
| ------------------------------------- | -------------------------------------------------------- | ------------------------- |
| [`variables`](#variables)             | Значения для интерполяции с именованными ключами.        | `Record<string, unknown>` |
| [`$context`](#context)                | Контекст для снятия неоднозначности у переводчиков.      | `string`                  |
| [`$id`](#id)                          | Стабильный идентификатор записи для редактора переводов. | `string`                  |
| [`$format`](#format)                  | Формат данных сообщения (например, ICU, STRING).         | `string`                  |
| [`$locale`](#locale)                  | Переопределяет целевую локаль.                           | `string`                  |
| [`$maxChars`](#max-chars)             | Максимальная длина перевода.                             | `number`                  |
| [`$requiresReview`](#requires-review) | Требует утверждения человеком перед использованием.      | `boolean`                 |

### `variables` [#variables]

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

Любой ключ, не начинающийся с `$`, считается переменной интерполяции. Ссылайтесь на такой ключ в строке с помощью синтаксиса `{name}`; его значение подставляется в переведённую строку без перевода.

### `$context` [#context]

**Тип** `string` · **Необязательно**

Контекст для уточнения перевода; используется для разрешения неоднозначных фраз.

### `$id` [#id]

**Тип** `string` · **Необязательный**

Стабильный идентификатор записи, используемый в редакторе переводов.

### `$format` [#format]

**Тип** `string` · **Необязательно** · **По умолчанию** `ICU`

Формат данных сообщения (например, ICU, STRING). По умолчанию — ICU.

### `$locale` [#locale]

**Тип** `string` · **Необязательно**

Переопределяет целевую локаль для данного перевода.

### `$maxChars` [#max-chars]

**Тип** `number` · **Необязательно**

Ограничивает количество символов в переводе. Библиотека строго соблюдает это ограничение.

### `$requiresReview` [#requires-review]

**Тип** `boolean` · **Необязательно**

Если значение равно `true`, перевод помечается как требующий утверждения человеком перед использованием.

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

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, world!', { $context: 'a formal greeting' })}</div>;
};
```

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, {username}! How is your day?', { username: 'Brian123' })}</div>;
};
```

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

// ICU message format форматирует переменные
const Component = () => {
  const gt = useGT();
  return (
    <div>
      {gt('Your account balance: {dollars, number, ::currency/USD}!', { dollars: 1000000 })}
    </div>
  );
};
```

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Welcome to our application', { $maxChars: 15 })}</div>;
};
```

`gt-react` поддерживает [формат сообщений ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) для форматирования переменных.

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

* `InlineTranslationOptions` используется с [`useGT`](/docs/react/reference/hooks/use-gt) и [`msg`](/docs/react/reference/functions/msg).
* О поиске в словаре см. [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options).