# gt-next: General Translation Next.js SDK: tx
URL: https://generaltranslation.com/it/docs/next/api/strings/tx.mdx
---
title: tx
description: Riferimento API per la funzione tx per la traduzione delle stringhe
---

## Panoramica

La funzione `tx` è una funzione lato server per tradurre le stringhe.

```jsx
await tx('Hello, world!'); // restituisce 'Hola, mundo!'
```

<Callout>
  **Traduzione runtime:**
  Le traduzioni `tx` avvengono a runtime.
  Questo significa che la traduzione viene eseguita in tempo reale, quindi puoi tradurre contenuti disponibili a runtime.
</Callout>


## Riferimento

### Parametri

<TypeTable
  type={{
  "content": {
      type: 'string',
      optional: false,
  },
  "options?": {
      type: 'RuntimeTranslationOptions',
      optional: true,
      default: '{}',
  },
}}
/>

| Nome      | Descrizione                                                                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | La stringa da tradurre.                                                                                                                                  |
| `options` | Opzioni di traduzione per personalizzare il comportamento di `tx`. Vedi [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options). |

### Restituisce

Una Promise che restituisce una stringa contenente il contenuto tradotto oppure, se non è necessaria alcuna traduzione, il contenuto originale.

***

## Comportamento

La funzione `tx` traduce le stringhe a runtime.
Questo significa che le traduzioni vengono eseguite al momento dell&#39;esecuzione, quindi puoi tradurre contenuti noti solo a runtime.
Lo svantaggio è che c&#39;è un ritardo, perché il caricamento di una traduzione on-demand è significativamente più lento.

Il nostro consiglio è di tradurre tutto il possibile in fase di build usando [`getGT`](/docs/next/api/strings/use-gt), [`useGT`](/docs/next/api/strings/use-gt) o [`<T>`](/docs/next/api/components/t),
e di usare le traduzioni on-demand, come `tx` e [`<Tx>`](/docs/next/api/components/tx), solo quando necessario.

Assicurati di seguire la [guida al deployment disponibile qui](/docs/next/tutorials/quickdeploy).

***

## Esempio

### Utilizzo di base

Puoi usare `tx` per tradurre le stringhe.

```javascript title="src/components/translateGreeting.jsx" copy
import { tx } from 'gt-next/server';

export default async function translateGreeting() {
    return await tx("Hello, world!"); // [!code highlight]
}
```


### Aggiungere il contesto

Puoi personalizzare la traduzione fornendo un contesto da prendere in considerazione durante la traduzione.

```javascript title="TranslateWithOptions.jsx" copy
import { tx } from 'gt-next/server';

export default async function TranslateWithOptions() {
    return await tx("Hello, world!", {
      $context: 'Traduci in modo informale' // [!code highlight]
    });
}
```


### Uso delle variabili

Per passare valori alla tua stringa, devi (1) assegnare un identificatore e (2) fare riferimento a tale identificatore nell&#39;oggetto passato.

```jsx title="translateWithVariables.js" copy
// [!code word:price]
import { tx } from 'gt-next/server';

export default async function translateWithVariables() {
  return await tx("The cost is {price, number, ::currency/USD}", {
    price: 29.99,
  });
}
```


### Specificare un&#39;impostazione regionale

Puoi specificare un&#39;impostazione regionale da usare per la traduzione.
Per impostazione predefinita, viene usata l&#39;impostazione regionale della lingua preferita dell&#39;utente.

```jsx title="translateWithLocale.js" copy
import { tx } from 'gt-next/server';

export default async function translateWithLocale() {
    return await tx("Hello, world!", { $locale: 'fr' }); // [!code highlight]
}
```

***


## Note

* `tx` è destinato esclusivamente all&#39;uso lato server e non può essere usato nei componenti lato client.
* Le traduzioni con `tx` avvengono a runtime, cioè vengono tradotte in tempo reale. Questo è molto più lento delle traduzioni in fase di build.

## Passaggi successivi

* Consulta [`useGT`](/docs/next/api/strings/use-gt) e [`getGT`](/docs/next/api/strings/get-gt) per tradurre le stringhe prima del deployment.
* Per tradurre JSX, consulta [`<T>`](/docs/next/api/components/t) e [`<Tx>`](/docs/next/api/components/tx).
* Consulta [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) per ulteriori informazioni su come personalizzare le traduzioni.