# gt-next: General Translation Next.js SDK: tx
URL: https://generaltranslation.com/fr/docs/next/api/strings/tx.mdx
---
title: tx
description: Référence de l’API de la fonction tx de traduction de chaînes
---

## Vue d’ensemble

La fonction `tx` est une fonction de traduction côté serveur pour les chaînes de caractères.

```jsx
await tx('Hello, world!'); // retourne 'Hola, mundo!'
```

<Callout>
  **Traduction à l’exécution :**
  Les traductions `tx` ont lieu à l’exécution.
  Cela signifie que la traduction est effectuée à la volée, ce qui vous permet de traduire du contenu disponible à l’exécution.
</Callout>


## Référence

### Paramètres

<TypeTable
  type={{
  "content": {
      type: 'string',
      optional: false,
  },
  "options?": {
      type: 'RuntimeTranslationOptions',
      optional: true,
      default: '{}',
  },
}}
/>

| Nom       | Description                                                                                                                                                      |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | La chaîne qui doit être traduite.                                                                                                                                |
| `options` | Options de traduction permettant de personnaliser le comportement de `tx`. Voir [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options). |

### Retourne

Une promesse qui se résout en une chaîne contenant le contenu traduit, ou le contenu d’origine si aucune traduction n’est nécessaire.

***

## Comportement

La fonction `tx` traduit les chaînes à l’exécution.
Cela signifie que les traductions sont effectuées à la volée, ce qui vous permet de traduire du contenu qui n’est connu qu’à l’exécution.
L’inconvénient est qu’il faut attendre le chargement d’une traduction à la demande, ce qui est nettement plus lent.

Nous vous conseillons de traduire tout ce que vous pouvez au build à l’aide de [`getGT`](/docs/next/api/strings/use-gt), [`useGT`](/docs/next/api/strings/use-gt) ou [`<T>`](/docs/next/api/components/t),
et de n’utiliser les traductions à la demande, comme `tx` et [`<Tx>`](/docs/next/api/components/tx), qu’en cas de besoin.

Veillez à suivre le [guide de déploiement disponible ici](/docs/next/tutorials/quickdeploy).

***

## Exemple

### Utilisation de base

Vous pouvez utiliser `tx` pour traduire des chaînes de caractères.

```javascript title="src/components/translateGreeting.jsx" copy
import { tx } from 'gt-next/server';

export default async function translateGreeting() {
    return await tx("Hello, world!"); // [!code highlight]
}
```


### Ajouter du contexte

Vous pouvez personnaliser la traduction en fournissant un contexte à prendre en compte.

```javascript title="TranslateWithOptions.jsx" copy
import { tx } from 'gt-next/server';

export default async function TranslateWithOptions() {
    return await tx("Hello, world!", {
      $context: 'Translate informally' // [!code highlight]
    });
}
```


### Utilisation de variables

Pour transmettre des valeurs à votre chaîne, vous devez (1) attribuer un identifiant et (2) faire référence à cet identifiant dans l’objet transmis.

```jsx title="translateWithVariables.js" copy
// [!code word:price]
import { tx } from 'gt-next/server';

export default async function translateWithVariables() {
  return await tx("The cost is {price, number, ::currency/USD}", {
    price: 29.99,
  });
}
```


### Spécifier un paramètre régional

Vous pouvez spécifier le paramètre régional à utiliser pour la traduction.
Par défaut, le paramètre régional correspond à la langue préférée de l’utilisateur.

```jsx title="translateWithLocale.js" copy
import { tx } from 'gt-next/server';

export default async function translateWithLocale() {
    return await tx("Hello, world!", { $locale: 'fr' }); // [!code highlight]
}
```

***


## Remarques

* `tx` est réservé à un usage côté serveur et ne peut pas être utilisé dans des composants côté client.
* Les traductions avec `tx` ont lieu à l’exécution, c’est-à-dire en direct. C’est nettement plus lent que les traductions au build.

## Étapes suivantes

* Consultez [`useGT`](/docs/next/api/strings/use-gt) et [`getGT`](/docs/next/api/strings/get-gt) pour traduire des chaînes de caractères avant le déploiement.
* Pour traduire du JSX, consultez [`<T>`](/docs/next/api/components/t) et [`<Tx>`](/docs/next/api/components/tx).
* Consultez [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) pour en savoir plus sur la personnalisation des traductions.