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

{/* GENERATO AUTOMATICAMENTE: non modificare direttamente. Modifica il modello in content/docs-templates/. */}


## Panoramica

La funzione `useGT` è un hook per tradurre stringhe durante la fase di build.

```jsx
const gt = useGT();

<p>{gt('This text will be translated')}</p>;
```

<Callout>
  **Traduzione in fase di build:** le traduzioni con `useGT` avvengono in fase di build, prima
  che la tua app venga distribuita. Sebbene tu possa passare variabili alla stringa tradotta, puoi
  tradurre solo contenuti noti in fase di build.
</Callout>


## Riferimento

### Parametri

Nessuno

### Restituisce

Una funzione di callback, `gt`, che traduce il contenuto passato.

```jsx
(content: string, options?: InlineTranslationOptions) => string
```

| Nome       | Tipo                                                                          | Descrizione                                                        |
| ---------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `content`  | `string`                                                                      | Il contenuto testuale da tradurre.                                 |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Opzioni di traduzione per personalizzare il comportamento di `gt`. |

***


## Comportamento

### Produzione

Durante il processo di CD, qualsiasi contenuto all&#39;interno di una funzione `gt` verrà tradotto prima del deployment dell&#39;applicazione.
Questo garantisce tempi di caricamento rapidi per tutte le impostazioni regionali, ma può tradurre solo i contenuti noti in fase di build.

Una volta generate, le traduzioni vengono (1) memorizzate nella CDN oppure (2) nell&#39;output di build della tua app, in base alla configurazione.
Da lì, il contenuto tradotto viene servito agli utenti.
Se una traduzione non viene trovata, verrà usato il contenuto originale come fallback.

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

### Sviluppo

Durante lo sviluppo, la funzione `gt` traduce i contenuti su richiesta.
Questo è utile per farti un&#39;idea di come apparirà la tua app in lingue diverse.
Ricorda di aggiungere una chiave API Dev al tuo ambiente per abilitare questo comportamento.

Durante la traduzione su richiesta in fase di sviluppo noterai un ritardo.
Questo non si verificherà nelle build di produzione, a meno che i contenuti non vengano tradotti esplicitamente su richiesta.

***

## Esempio

### Utilizzo di base

Puoi usare `useGT` per tradurre delle stringhe.

```jsx copy
import { useGT } from 'gt-next';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

Nota: &quot;Alice&quot; sarà tradotto nella lingua preferita dell&#39;utente.


### Utilizzare le variabili [#variables]

Puoi passare variabili alle traduzioni del dizionario.

```jsx copy
import { useGT } from 'gt-next';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, {name}!', { name: 'Alice' })}</p>;
}
```

Nota: &quot;Alice&quot; non verrà tradotto nella lingua preferita dell&#39;utente perché è una variabile.


### Uso del formato dei messaggi ICU

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

```jsx copy
import { useGT } from 'gt-next';

export default function TranslateGreeting() {
  const gt = useGT();
  return (
    <p>
      {gt(
        'There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart',
        { count: 10 }
      )}
    </p>
  );
}
```

<Callout>
  Il formato dei messaggi ICU è un modo efficace per formattare le variabili. Per
  ulteriori informazioni, consulta la [documentazione del formato dei messaggi
  ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

### Importare da `gt-next`

Se stai usando la direttiva `"use client"`, devi importare da `gt-next` invece che da `gt-next`.

```jsx copy
'use client';
import { useGT } from 'gt-next';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

***


## Note

* La funzione `useGT` è un hook che traduce le stringhe.
* La traduzione delle stringhe con `useGT` avviene prima del runtime, durante il processo di build (tranne che in fase di sviluppo).