# General Translation React SDKs (gt-react, gt-next): useGT
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-gt.mdx
---

title: useGT
description: Obtenez une fonction pour traduire des chaînes directement dans le code avec General Translation gt-react. Référence de l’API pour useGT.

---

Le hook `useGT` renvoie une fonction qui traduit des chaînes dans le paramètre régional actif. Utilisez-la pour les libellés, les placeholders et d’autres chaînes autonomes, lorsque [`<T>`](/docs/react/reference/components/t) n’est pas adapté.

*Disponible dans `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`. Les exemples importent depuis `gt-react` ; importez plutôt depuis le package de votre framework.*

## Vue d’ensemble [#overview]

Appelez `useGT` pour récupérer la fonction de traduction, puis passez-lui une chaîne. Cette fonction est renvoyée directement.

```tsx
const gt = useGT();

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

*Remarque : dans `gt-react`, appelez `useGT` à l’intérieur d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne aussi dans les composants serveur synchrones. Écrivez `const gt = useGT()` — le hook renvoie directement la fonction, pas un objet.*

## Fonctionnement [#how-it-works]

* **Traduction au build.** En production, les chaînes transmises à `gt` sont traduites pendant le build, avant le déploiement. Seul le contenu connu au moment du build peut être traduit. Les traductions manquantes retombent sur la chaîne source.
* **À la demande en développement.** Avec une clé API de développement, `gt` traduit à la demande pour vous permettre de prévisualiser les locales, avec un léger délai qui n&#39;existe pas en production.
* **Les variables ne sont pas traduites.** Les valeurs interpolées sont insérées dans la chaîne traduite, mais ne sont jamais traduites elles-mêmes.

## Paramètres [#parameters]

`useGT` ne prend aucun paramètre.

## Retourne [#returns]

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

Une fonction qui traduit la chaîne fournie selon le paramètre régional actif.

| Nom       | Description                                                                       | Type                                                                                 | Facultatif |
| --------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------- |
| `content` | La chaîne à traduire.                                                             | `string`                                                                             | Non        |
| `options` | Variables d’interpolation et options telles que `$context`, `$id` et `$maxChars`. | [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options) | Oui        |

## Exemples [#examples]

```tsx
import { useGT } from 'gt-react';

export default function TranslateGreeting() {
  const gt = useGT();
  return <p>{gt('Hello, Alice!')}</p>;
}
// "Hello, Alice!" est traduit selon le paramètre régional de l'utilisateur.
```

```tsx
import { useGT } from 'gt-react';

export default function TranslateGreeting() {
  const gt = useGT();
  return <p>{gt('Hello, {name}!', { name: 'Alice' })}</p>;
}
// "Alice" est une variable et n'est pas traduite.
```

```tsx
import { useGT } from 'gt-react';

export default function ItemCount() {
  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>
  );
}
```

`gt-react` prend en charge le [format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) pour mettre en forme les variables.

## Remarques [#notes]

* `useGT` traduit les chaînes ; les traductions se font au build (ou à la demande en développement).
* Dans un composant App Router asynchrone, utilisez plutôt [`getGT`](/docs/react/nextjs/reference/functions/get-gt).
* Pour les recherches dans le dictionnaire par id, utilisez [`useTranslations`](/docs/react/reference/hooks/use-translations) ; pour enregistrer des chaînes au niveau du module, utilisez [`msg`](/docs/react/reference/functions/msg) avec [`useMessages`](/docs/react/reference/hooks/use-messages).