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

title: InlineTranslationOptions
description: Opzioni per trasmettere variabili e metadati alle traduzioni inline delle stringhe con General Translation gt-react. Riferimento API per InlineTranslationOptions.

---

`InlineTranslationOptions` è l'oggetto options per le traduzioni inline delle stringhe. Include variabili di interpolazione e metadati come context e un identificatore. È accettato da [`useGT`](/docs/react/reference/hooks/use-gt) e [`msg`](/docs/react/reference/functions/msg).

*Queste opzioni si applicano ovunque siano disponibili [`useGT`](/docs/react/reference/hooks/use-gt) e [`msg`](/docs/react/reference/functions/msg) — `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`. Il tipo denominato `GTTranslationOptions` è esportato da `gt-react`, `gt-next` e `gt-react-native`; `gt-tanstack-start` riesporta le funzioni ma non il tipo.*

## Panoramica [#overview]

Passa le variabili di interpolazione come semplici chiavi e i metadati di traduzione con chiavi precedute da `$`.

```typescript
type InlineTranslationOptions = {
  [variable: string]: unknown; // variabili di interpolazione
  $context?: string;
  $id?: string;
  $format?: string;
  $locale?: string;
  $maxChars?: number;
  $requiresReview?: boolean;
};
```

*Nota: in `gt-react` v11, questo oggetto options corrisponde al tipo esportato `GTTranslationOptions`. Le variabili vengono inserite nella traduzione, ma non vengono mai tradotte.*

## Proprietà [#properties]

| Proprietà                             | Descrizione                                                  | Tipo                      |
| ------------------------------------- | ------------------------------------------------------------ | ------------------------- |
| [`variables`](#variables)             | Valori di interpolazione, associati per nome.                | `Record<string, unknown>` |
| [`$context`](#context)                | Contesto di disambiguazione per i traduttori.                | `string`                  |
| [`$id`](#id)                          | Identificatore stabile della voce per il Translation Editor. | `string`                  |
| [`$format`](#format)                  | Formato dei dati del messaggio (ad es. ICU, STRING).         | `string`                  |
| [`$locale`](#locale)                  | Sovrascrive l&#39;impostazione regionale di destinazione.    | `string`                  |
| [`$maxChars`](#max-chars)             | Lunghezza massima della traduzione.                          | `number`                  |
| [`$requiresReview`](#requires-review) | Richiede l&#39;approvazione umana prima dell&#39;uso.        | `boolean`                 |

### `variables` [#variables]

**Tipo** `Record<string, unknown>`

Qualsiasi chiave diversa da `$` viene trattata come una variabile di interpolazione. Richiamala nella stringa con la sintassi `{name}`; il suo valore viene inserito nella stringa tradotta senza essere a sua volta tradotto.

### `$context` [#context]

**Tipo** `stringa` · **Facoltativo**

Contesto per perfezionare la traduzione, usato per chiarire espressioni ambigue.

### `$id` [#id]

**Tipo** `stringa` · **Facoltativo**

Un identificatore stabile per la voce, usato con il Translation Editor.

### `$format` [#format]

**Type** `stringa` · **Facoltativo** · **Predefinito** `ICU`

Il formato dei dati del messaggio (ad esempio ICU, STRING). Il valore predefinito è ICU.

### `$locale` [#locale]

**Tipo** `stringa` · **Facoltativo**

Sovrascrive l&#39;impostazione regionale di destinazione di questa traduzione.

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

**Type** `number` · **Facoltativo**

Limita il numero di caratteri della traduzione. La libreria impone questo limite.

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

**Tipo** `boolean` · **Facoltativo**

Quando è `true`, indica che la traduzione richiede l&#39;approvazione umana prima di essere utilizzata.

## Esempi [#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';

// Il formato ICU message format formatta le variabili
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` supporta [ICU message format](https://unicode-org.github.io/icu/userguide/format_parse/messages/) per la formattazione delle variabili.

## Note [#notes]

* `InlineTranslationOptions` si usa con [`useGT`](/docs/react/reference/hooks/use-gt) e [`msg`](/docs/react/reference/functions/msg).
* Per i lookup nel dizionario, vedi [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options).