# vue: t
URL: https://generaltranslation.com/it/docs/vue/reference/functions/t.mdx
---

title: t
description: Traduce in modo sincrono una semplice stringa dal runtime SPA inizializzato nel browser. Riferimento API per t.

---

Usa `t` per costanti e altre stringhe valutate al di fuori dei componenti Vue in una single-page app eseguita solo nel browser. Il codice dei componenti usa invece normalmente la callback reattiva [`useGT()`](/docs/vue/reference/composables/use-gt).

## Panoramica [#overview]

```ts
const t: GTFunction;
```

La funzione legge il catalogo precaricato da [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa):

```ts title="src/navigation.ts"
import { t } from 'gt-vue';

export const navigation = [
  t('Documentation', { $context: 'primary navigation' }),
  t('Account settings'),
];
```

Usa stringhe sorgente letterali e un `$context` letterale affinché la CLI possa estrarre la stessa voce di catalogo di cui il runtime calcola l'hash.

## Parametri [#parameters]

| Parametro | Descrizione                                                                  | Tipo                                                             | Facoltativo | Predefinito |
| --------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| `message` | Stringa sorgente statica da tradurre. Le parentesi graffe restano letterali. | `string`                                                         | No          | —           |
| `options` | Contesto usato per disambiguare l'hash del catalogo.                     | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Sì          | `{}`        |

`$context` è l'unica opzione supportata. `t` non accetta variabili di interpolazione, `$format`, `$maxChars` o `$requiresReview`.

## Come funziona [#how-it-works]

`t` calcola l'hash del catalogo `STRING` semplice a partire da `message` e `$context`, quindi legge in modo sincrono il catalogo SPA attivo. Restituisce la stringa sorgente se l'hash non è presente o se il valore del catalogo non è una stringa.

Il risultato è uno snapshot prodotto al momento dell'esecuzione della chiamata. Una costante a livello di modulo non partecipa alla reattività di Vue. Le modifiche dell'impostazione regionale della SPA ricaricano quindi il documento, rieseguono il bootstrap, precaricano il nuovo catalogo e rivalutano il modulo.

Questa API esegue solo la ricerca letterale di stringhe:

* Le parentesi graffe come `{name}` sono caratteri ordinari.
* La sintassi ICU non viene analizzata né formattata.
* I valori a Runtime non vengono interpolati.
* La sintassi dei template taggati come `` t`Hello` `` non è supportata.

Usa [`<T>`](/docs/vue/reference/components/t) con [`<Var>`](/docs/vue/reference/components/var) per contenuti traducibili che contengono valori a Runtime.

## Valore restituito [#returns]

**Tipo** `stringa`

Restituisce la traduzione della stringa corrispondente oppure `message` se non esiste alcuna traduzione della stringa.

## Errori [#failures]

`t` genera un&#39;eccezione in uno dei seguenti casi:

* Viene eseguito sul server, dove lo stato di traduzione globale del browser potrebbe propagarsi tra le richieste.
* Viene eseguito nel browser prima che [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) abbia completato l&#39;inizializzazione.

Attendi l&#39;inizializzatore in un modulo di bootstrap, quindi importa dinamicamente i moduli che chiamano `t`. Per il rendering lato server, configura lo stato [`createGT({ locale })`](/docs/vue/reference/functions/create-gt#server-rendering) con ambito di richiesta e traduci da un componente con [`useGT()`](/docs/vue/reference/composables/use-gt).

## Esempio [#example]

```ts title="src/status.ts"
import { t } from 'gt-vue';

export const STATUS_LABELS = {
  draft: t('Draft', { $context: 'document status' }),
  published: t('Published', { $context: 'document status' }),
};
```

L&#39;estrattore registra entrambe le chiamate. Se il catalogo attivo non è disponibile o non contiene nessuna delle due voci, i valori sono `"Draft"` e `"Published"`.