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

title: t
description: Traduit de manière synchrone une simple chaîne de caractères depuis le runtime SPA initialisé dans le navigateur. Référence d’API de t.

---

Utilisez `t` pour les constantes et autres chaînes de caractères évaluées en dehors des composants Vue dans une application monopage exécutée uniquement dans le navigateur. Le code des composants utilise généralement le callback réactif [`useGT()`](/docs/vue/reference/composables/use-gt) à la place.

## Vue d’ensemble [#overview]

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

La fonction lit le catalogue préchargé par [`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'),
];
```

Utilisez des chaînes source littérales et un `$context` littéral afin que la CLI puisse extraire la même entrée du catalogue que celle hachée à l’exécution.

## Paramètres [#parameters]

| Paramètre | Description                                                          | Type                                                             | Facultatif | Par défaut |
| --------- | -------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------- | ---------- |
| `message` | Chaîne source statique à traduire. Les accolades restent littérales. | `string`                                                         | Non        | —          |
| `options` | Contexte permettant de lever l’ambiguïté du hachage du catalogue.    | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Oui        | `{}`       |

`$context` est la seule option prise en charge. `t` n’accepte ni les variables d’interpolation, ni `$format`, `$maxChars` ou `$requiresReview`.

## Fonctionnement [#how-it-works]

`t` calcule le hachage du catalogue `STRING` brut à partir de `message` et de `$context`, puis lit de manière synchrone le catalogue SPA actif. Elle renvoie la chaîne source si le hachage est absent ou si la valeur du catalogue n’est pas une chaîne.

Le résultat est un instantané produit lors de l’exécution de l’appel. Une constante définie au niveau du module ne participe pas à la réactivité de Vue. Les changements de paramètre régional de la SPA rechargent donc le document, relancent l’amorçage, préchargent le nouveau catalogue et réévaluent le module.

Cette API effectue uniquement une recherche littérale de chaîne :

* Les accolades telles que `{name}` sont des caractères ordinaires.
* La syntaxe ICU n’est ni analysée ni formatée.
* Les valeurs d’exécution ne sont pas interpolées.
* La syntaxe des modèles balisés telle que `` t`Hello` `` n’est pas prise en charge.

Utilisez [`<T>`](/docs/vue/reference/components/t) avec [`<Var>`](/docs/vue/reference/components/var) pour le contenu traduisible contenant des valeurs d’exécution.

## Valeur de retour [#returns]

**Type** `string`

Renvoie la traduction de chaîne correspondante ou `message` si aucune traduction de chaîne n’est disponible.

## Échecs [#failures]

`t` lève une exception dans l’un ou l’autre des cas suivants :

* Il s’exécute sur le serveur, où l’état global de traduction du navigateur pourrait fuiter d’une requête à l’autre.
* Il s’exécute dans le navigateur avant la fin de [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa).

Attendez l’initialisation dans un module d’amorçage, puis importez dynamiquement les modules qui appellent `t`. Pour le rendu côté serveur, installez un état [`createGT({ locale })`](/docs/vue/reference/functions/create-gt#server-rendering) limité à la requête et traduisez depuis un composant avec [`useGT()`](/docs/vue/reference/composables/use-gt).

## Exemple [#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’extracteur enregistre les deux appels. Si le catalogue actif est indisponible ou ne contient aucune des deux entrées, les valeurs sont `"Draft"` et `"Published"`.