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

title: useMessages
description: Risolve le stringhe registrate con msg nell'impostazione regionale attiva con General Translation gt-react. Riferimento API per useMessages.

---

L'hook `useMessages` restituisce una funzione che risolve le stringhe codificate create con [`msg`](/docs/react/reference/functions/msg) nell'impostazione regionale attiva. Usalo per tradurre stringhe registrate a livello di modulo, al di fuori di un componente.

*Disponibile in `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`. Gli esempi importano da `gt-react`; importa invece dal pacchetto del framework che stai usando.*

## Panoramica [#overview]

Registra una stringa con `msg`, quindi risolvila con la funzione restituita da `useMessages`.

```tsx
const m = useMessages();

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

*Nota: in `gt-react`, chiama `useMessages` all&#39;interno di un [`<GTProvider>`](/docs/react/reference/components/gt-provider). In `gt-next`, funziona anche nei componenti server sincroni.*

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

* **Risolve le stringhe registrate.** Cerca la traduzione di una stringa precedentemente codificata tramite [`msg`](/docs/react/reference/functions/msg) e la restituisce nell&#39;impostazione regionale attiva.
* **Pass-through.** `null` e `undefined` vengono restituiti invariati.
* **Precedenza delle variabili.** Quando le variabili vengono passate sia a `msg` sia al resolver, i valori passati a `msg` hanno la precedenza.
* **Traduzione in fase di build.** Come [`useGT`](/docs/react/reference/hooks/use-gt), la traduzione avviene in fase di build (o su richiesta durante lo sviluppo) e le variabili non vengono mai tradotte.

## Parametri [#parameters]

`useMessages` non accetta alcun parametro.

## Valore restituito [#returns]

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

Una funzione che risolve il contenuto codificato di `msg` per l&#39;impostazione regionale attiva.

| Nome             | Descrizione                                                     | Tipo     | Facoltativo |
| ---------------- | --------------------------------------------------------------- | -------- | ----------- |
| `encodedContent` | La stringa codificata di `msg` da risolvere.                    | `string` | No          |
| `options`        | Variabili di interpolazione da passare alla stringa codificata. | `object` | Sì          |

## Esempi [#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>; // "Ciao, Bob!"
}
```

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

// Le variabili passate a msg() hanno la precedenza su quelle passate a m()
const encodedGreeting = msg('Hello, {name}!', { name: 'Alice' });

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

## Note [#notes]

* `useMessages` risolve le stringhe codificate da [`msg`](/docs/react/reference/functions/msg).
* In un componente App Router asincrono, usa invece [`getMessages`](/docs/react/nextjs/reference/functions/get-messages).
* Le traduzioni avvengono in fase di build (oppure su richiesta durante lo sviluppo).