# gt-react: General Translation React SDK: msg
URL: https://generaltranslation.com/it/docs/react/api/strings/msg.mdx
---
title: msg
description: Riferimento API per la funzione `msg()` per le stringhe
---

{/* GENERATO AUTOMATICAMENTE: non modificare direttamente. Modifica il template in content/docs-templates/. */}


## Panoramica

La funzione `msg` contrassegna e codifica le stringhe per la traduzione.

```jsx
const encodedString = msg('Hello, world!');
```

La stringa codificata deve essere passata all'Hook [`useMessages`](/docs/react/api/strings/use-messages) per ottenere le traduzioni.

<Callout>
  **Codifica:**
  `msg` codifica la stringa di input, quindi non puoi usarla direttamente in JSX o altrove.
  Se vuoi recuperare la stringa originale, devi decodificarla con [`decodeMsg`](#decodemsg)
</Callout>


## Decodifica [#decodemsg]

Per ottenere di nuovo la stringa originale, devi decodificarla con [`decodeMsg`](#decodemsg)

```jsx
import { msg, decodeMsg } from 'gt-react';
const encodedString = msg('Hello, world!');
const decodedString = decodeMsg(encodedString);
console.log(decodedString); // "Hello, world!"
```


## Riferimento

### Parametri

| Nome       | Tipo                                                                           | Descrizione                                                         |
| ---------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| `content`  | `string`                                                                       | Il contenuto testuale da codificare.                                |
| `options?` | [`InlineTranslationOptions`](/docs/react/api/types/inline-translation-options) | Opzioni di traduzione per personalizzare il comportamento di `msg`. |

### Restituisce

Una stringa codificata, in cui le variabili interpolate (se presenti) vengono sostituite con i rispettivi valori.

***

## Comportamento

### Produzione

Durante il processo di CD, qualsiasi contenuto all&#39;interno di una funzione `msg` viene tradotto prima del deployment dell&#39;applicazione.
Questo garantisce tempi di caricamento rapidi per tutte le impostazioni regionali, ma può tradurre solo i contenuti noti nella fase di build.

Una volta generate, le traduzioni vengono (1) archiviate nella CDN oppure (2) salvate nell&#39;output di build della tua app, in base alla tua configurazione.
Da lì, il contenuto tradotto viene distribuito agli utenti.
Se una traduzione non viene trovata, viene usato il contenuto originale come fallback.

Assicurati di seguire la [guida al deployment qui](/docs/react/tutorials/quickdeploy).

### Sviluppo

Durante lo sviluppo, la funzione `msg` tradurrà i contenuti on-demand.
Questo è utile per creare prototipi e vedere come apparirà la tua app in diverse lingue.
Ricorda di aggiungere una API key Dev al tuo ambiente per abilitare questo comportamento.

Noterai un ritardo durante la traduzione on-demand in fase di sviluppo.
Questo non si verificherà nelle build di produzione, a meno che il contenuto non venga tradotto esplicitamente on-demand.

***

## Esempio

### Utilizzo di base

Puoi usare `msg` per contrassegnare le stringhe da tradurre.

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

const encodedString = msg('Hello, world!');

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

Nota: &quot;Hello, world!&quot; verrà tradotto nella lingua preferita dell&#39;utente.


### Uso delle variabili [#variables]

Puoi passare variabili alle traduzioni della dictionary.

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

const encodedString = msg('Hello, {name}!', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();

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

Nota: &quot;Alice&quot; non verrà tradotto nella lingua preferita dell&#39;utente perché si tratta di una variabile.


### Uso del formato dei messaggi ICU

`gt-react` supporta il formato dei messaggi ICU, che consente anche di formattare le variabili.

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

const encodedString = msg('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 });

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

<Callout>
  Il formato dei messaggi ICU è uno strumento potente per formattare le variabili.
  Per maggiori informazioni, consulta la [documentazione sul formato dei messaggi ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Note

* La funzione `msg` serve a contrassegnare le stringhe da tradurre.
* La traduzione delle stringhe con `msg` avviene prima del runtime, durante il processo di build (a meno che non si sia in sviluppo).

## Passaggi successivi

* Consulta [`useMessages`](/docs/react/api/strings/use-messages) per tradurre le stringhe.