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

title: useMessages
description: Résout les chaînes enregistrées avec msg selon le paramètre régional actif avec General Translation gt-react. Référence de l’API pour useMessages.

---

Le hook `useMessages` renvoie une fonction qui résout les chaînes encodées créées avec [`msg`](/docs/react/reference/functions/msg) selon le paramètre régional actif. Utilisez-le pour traduire les chaînes enregistrées au niveau du module, en dehors d’un composant.

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

Enregistrez une chaîne avec `msg`, puis résolvez-la à l’aide de la fonction renvoyée par `useMessages`.

```tsx
const m = useMessages();

<p>{m(encodedString)}</p>;
```

*Remarque : dans `gt-react`, appelez `useMessages` au sein d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne également dans les composants serveur synchrones.*

## Fonctionnement [#how-it-works]

* **Résolution des chaînes enregistrées.** Recherche la traduction d&#39;une chaîne précédemment encodée par [`msg`](/docs/react/reference/functions/msg) et la renvoie dans le paramètre régional actif.
* **Transmission telle quelle.** `null` et `undefined` sont renvoyés inchangés.
* **Priorité des variables.** Lorsque des variables sont transmises à la fois à `msg` et à la fonction de résolution, les valeurs fournies à `msg` priment.
* **Traduction au build.** Comme [`useGT`](/docs/react/reference/hooks/use-gt), la traduction a lieu au build (ou à la demande en développement), et les variables ne sont jamais traduites.

## Paramètres [#parameters]

`useMessages` n&#39;accepte aucun paramètre.

## Renvoie [#returns]

**Type** `(encodedContent: string, options?: object) => string`

Une fonction qui résout le contenu encodé de `msg` selon le paramètre régional actif.

| Nom              | Description                                                  | Type     | Facultatif |
| ---------------- | ------------------------------------------------------------ | -------- | ---------- |
| `encodedContent` | La chaîne encodée de `msg` à résoudre.                       | `string` | Non        |
| `options`        | Variables d’interpolation à transmettre à la chaîne encodée. | `object` | Oui        |

## Exemples [#examples]

```tsx
import { msg, useMessages } from 'gt-react';

const encodedGreeting = msg('Hello, Alice!');

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting)}</p>;
}
```

```tsx
import { msg, useMessages } from 'gt-react';

const encodedGreeting = msg('Hello, {name}!');

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting, { name: 'Bob' })}</p>; // « Bonjour, Bob ! »
}
```

```tsx
import { msg, useMessages } from 'gt-react';

// Les variables passées à msg() ont la priorité sur celles passées à m()
const encodedGreeting = msg('Hello, {name}!', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting, { name: 'Bob' })}</p>; // "Hello, Alice!"
}
```

## Remarques [#notes]

* `useMessages` résout les chaînes encodées générées par [`msg`](/docs/react/reference/functions/msg).
* Dans un composant App Router asynchrone, utilisez plutôt [`getMessages`](/docs/react/nextjs/reference/functions/get-messages).
* Les traductions ont lieu au build (ou à la demande en développement).