# gt-next: General Translation Next.js SDK: InlineTranslationOptions
URL: https://generaltranslation.com/it/docs/next/api/types/inline-translation-options.mdx
---
title: InlineTranslationOptions
description: Riferimento dell'API per il tipo InlineTranslationOptions
---

## Panoramica

Il tipo `InlineTranslationOptions` viene utilizzato per passare variabili alle traduzioni inline e specificarne il comportamento di rendering.
Puoi anche aggiungere contesto e un identificatore alla traduzione.
Viene utilizzato con [`useGT`](/docs/next/api/strings/use-gt), [`getGT`](/docs/next/api/strings/get-gt) e [`msg`](/docs/next/api/strings/msg) per passare variabili alle traduzioni inline di stringhe.

<Callout>
  **Traduzione in fase di build:**
  Le variabili non vengono tradotte con `useGT`, `getGT` e `msg`; viene tradotta solo la stringa originale.
  Consulta [`tx`](/docs/next/api/strings/tx) per tradurre stringhe con contenuto dinamico.
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
  "$context?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
  "$id?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
  "$maxChars?": {
      type: 'number',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Descrizione

| Prop         | Descrizione                                                                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `[variable]` | Le variabili vengono passate come chiavi di primo livello nell&#39;oggetto `options`. I nomi delle chiavi corrispondono ai segnaposto nella stringa (ad esempio, `{username}`). |
| `$context`   | Fornisce un contesto per il contenuto, così da guidare la traduzione.                                                                                                           |
| `$id`        | Fornisce un identificatore da usare con l&#39;editor di traduzione.                                                                                                             |
| `$maxChars`  | Limita il numero di caratteri della traduzione. La libreria applica rigorosamente questo limite.                                                                                |

***

## Esempi

### Contesto

Per aggiungere un contesto alla stringa, usiamo la prop `$context`.

```jsx title="Component.tsx"
// [!code word:$context]
import { useGT } from 'gt-next';

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


### Passaggio di variabili

Per aggiungere una variabile alla stringa, usa la sintassi `{variable-name}`, in cui il nome della variabile è racchiuso tra parentesi graffe.

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

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


### Utilizzo del formato dei messaggi ICU

`gt-next` supporta il formato dei messaggi ICU, che ti consente anche di formattare le variabili.

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

const Component = () => {
  const gt = useGT();
  return <div>
    { gt(
      'Your account balance: {dollars, number, ::currency/USD}!',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};
```

Per ulteriori informazioni sul formato dei messaggi ICU, consulta la [documentazione sul formato dei messaggi ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).


### Limiti di caratteri

Usa `$maxChars` per limitare la lunghezza della traduzione:

```jsx title="Component.tsx"
// [!code word:$maxChars]
import { useGT } from 'gt-next';

const Component = () => {
  const gt = useGT();
  return <div>{gt('Welcome to our application', { $maxChars: 15 })}</div>; 
  // Output: "Bienvenue à no\u202F…"
};
```

***


## Note

* `InlineTranslationOptions` viene utilizzato per le traduzioni inline delle stringhe.
* Le variabili vengono passate come chiavi di primo livello nell&#39;oggetto options, non annidate sotto una chiave `variables`.

## Passaggi successivi

* Consulta [`useGT`](/docs/next/api/strings/use-gt) e [`getGT`](/docs/next/api/strings/get-gt) per ulteriori informazioni sulle traduzioni inline delle stringhe.
* Consulta [`formato dei messaggi ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) per ulteriori informazioni sulle opzioni di formattazione.