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

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


## Panoramica

La funzione `useGT` è un Hook per tradurre stringhe in fase di build.

```jsx
const gt = useGT();

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

<Callout>
  **Traduzione in fase di build:** le traduzioni `useGT` avvengono in fase di build, prima
  che la tua app venga distribuita. Anche se puoi 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 specificato.

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

| Nome       | Tipo                                                                           | Descrizione                                                        |
| ---------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| `content`  | `string`                                                                       | Il contenuto testuale da tradurre.                                 |
| `options?` | [`InlineTranslationOptions`](/docs/react/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 che l&#39;applicazione venga distribuita.
Questo garantisce tempi di caricamento rapidi per tutte le impostazioni regionali, ma può tradurre solo i contenuti noti nella fase di build.

Una volta generate, le traduzioni vengono (1) memorizzate nella CDN oppure (2) memorizzate nell&#39;output di build dell&#39;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.

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

### Sviluppo

Durante lo sviluppo, la funzione `gt` tradurrà i contenuti on-demand.
Questo è utile per fare prototipi e vedere come apparirà la tua app in lingue diverse.
Ricorda di aggiungere una chiave API di sviluppo al tuo ambiente per abilitare questo comportamento.

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

***

## Esempio

### Utilizzo di base

Puoi usare `useGT` per tradurre le stringhe.

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

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

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

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


### Uso delle variabili [#variables]

Puoi passare variabili alle traduzioni del dizionario.

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

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.


### Utilizzo del formato dei messaggi ICU

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

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

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 sistema potente 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>


### Import da `gt-react`

Se usi la direttiva `"use client"`, dovresti importare da `gt-react` anziché da `gt-react`.

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

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).