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

## Panoramica

Il tipo `RuntimeTranslationOptions` viene usato per passare variabili alle traduzioni inline e specificarne le modalità di rendering.
Puoi anche aggiungere un'impostazione regionale per specificare una lingua diversa per la traduzione.
Viene usato con la funzione [`tx`](/docs/next/api/strings/tx).

<Callout>
  **Traduzione runtime:**
  Per tradurre una variabile su richiesta, includila direttamente nella stringa passata a [`tx`](/docs/next/api/strings/tx).
  Le variabili passate a `tx` tramite l&#39;oggetto `options` non vengono tradotte.
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
  "$locale?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
  "$context?": {
      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 delle opzioni. I nomi delle chiavi corrispondono ai segnaposto nella stringa (ad esempio, `{username}`).          |
| `$locale`    | Specifica un&#39;impostazione regionale per la traduzione. Per impostazione predefinita, verrà usata l&#39;impostazione regionale preferita del browser tra quelle supportate dalla tua app. |
| `$maxChars`  | Limita il numero di caratteri della traduzione. La libreria applica rigorosamente questo limite.                                                                                             |

***

## Esempi

### Passare variabili

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

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

const Component = () => {
  return <div>
    {tx(`Hello, {username}!`,{ 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 { tx } from 'gt-next/server';

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


### Tradurre le variabili

Per tradurre una variabile, includila direttamente nella stringa passata a `tx`.

```jsx title="Component.tsx"
import { tx } from 'gt-next/server';

const Component = ({ hairColor }: { hairColor: string }) => {
  return <div>{tx(
    `Hello, {username}! Your haircolor is ${hairColor}`,
    { username: 'Brian123' }
  )}</div>;
};
```

Nota che la variabile `hairColor` viene tradotta, mentre `username` no.


### Specificare un’impostazione regionale

Puoi specificare l’impostazione regionale da usare per la traduzione.

```jsx title="Component.tsx"
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>{tx('Hello, world!', { $locale: 'fr' })}</div>;
};
```

Questo sarà sempre tradotto in francese.

### Limiti di caratteri

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

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

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

***


## Note

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

## Passaggi successivi

* Consulta [`tx`](/docs/next/api/strings/tx) 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.