# react-native: useGT
URL: https://generaltranslation.com/it/docs/react-native/api/strings/use-gt.mdx
---
title: useGT
description: Riferimento API per la 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 le 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 con `useGT` avvengono in fase di build, prima
  del deployment dell&#39;app. Anche se puoi passare variabili alla stringa tradotta, puoi
  tradurre solo contenuti noti in fase di build.
</Callout>


## Riferimento

### Parametri

Nessuno

### Restituisce

Una funzione 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-native/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` viene tradotto prima della distribuzione dell&#39;applicazione.
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) 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à utilizzato il contenuto originale come fallback.

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

### Sviluppo

Durante lo sviluppo, la funzione `gt` tradurrà i contenuti on-demand.
Questo è utile per farti un&#39;idea di 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-native';

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-react-native';

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-react-native` supporta il formato dei messaggi ICU, che consente anche di formattare le variabili.

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

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


### Importazione da `gt-react-native`

Se stai usando la direttiva `"use client"`, dovresti importare da `gt-react-native` invece che da `gt-react-native`.

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

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