# gt-next: General Translation Next.js SDK: msg
URL: https://generaltranslation.com/fr/docs/next/api/strings/msg.mdx
---
title: msg
description: Référence d’API pour la fonction de chaîne de caractères `msg()`
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas directement. Modifiez plutôt le modèle dans content/docs-templates/. */}


## Vue d’ensemble

La fonction `msg` sert à marquer et encoder des chaînes de caractères à traduire.

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

La chaîne de caractères encodée doit être transmise au hook [`useMessages`](/docs/next/api/strings/use-messages) afin de récupérer les traductions.

<Callout>
  **Encodage :**
  `msg` encode la chaîne de caractères d’entrée ; vous ne pouvez donc pas l’utiliser directement dans du JSX ni ailleurs.
  Si vous voulez récupérer la chaîne de caractères d’origine, vous devez la décoder avec [`decodeMsg`](#decodemsg)
</Callout>


## Décodage [#decodemsg]

Pour récupérer la chaîne de caractères d’origine, vous devez la décoder avec [`decodeMsg`](#decodemsg)

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


## Référence

### Paramètres

| Name       | Type                                                                          | Description                                                                 |
| ---------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `content`  | `string`                                                                      | Le contenu de la chaîne de caractères à encoder.                            |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Options de traduction permettant de personnaliser le comportement de `msg`. |

### Valeur de retour

Une chaîne de caractères encodée, dans laquelle les variables interpolées, le cas échéant, sont remplacées par leurs valeurs.

***

## Comportement

### Production

Pendant le processus de CD, tout contenu placé dans une fonction `msg` sera traduit avant le déploiement de votre application.
Cela garantit des temps de chargement rapides pour tous les paramètres régionaux, mais ne permet de traduire que le contenu connu au moment du build.

Une fois générées, les traductions sont soit (1) stockées dans le CDN, soit (2) incluses dans la sortie de build de votre application, selon votre configuration.
Le contenu traduit est ensuite servi à vos utilisateurs.
Si aucune traduction n&#39;est trouvée, le contenu d&#39;origine est utilisé.

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

### Développement

Pendant le développement, la fonction `msg` traduit le contenu à la demande.
C’est utile pour prototyper l’apparence de votre application dans différentes langues.
N’oubliez pas d’ajouter une clé API de développement à votre environnement pour activer ce comportement.

Vous constaterez un délai lors de la traduction à la demande en développement.
Cela ne se produira pas dans les builds de production, sauf si du contenu est explicitement traduit à la demande.

***

## Exemple

### Utilisation de base

Vous pouvez utiliser `msg` pour marquer des chaînes de caractères comme étant à traduire.

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

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

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

Remarque : &quot;Bonjour, monde !&quot; sera traduit dans la langue préférée de l&#39;utilisateur.


### Utiliser des variables [#variables]

Vous pouvez transmettre des variables aux traductions du dictionnaire.

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

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

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

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

Remarque : &quot;Alice&quot; ne sera pas traduite dans la langue préférée de l’utilisateur, car c’est une variable.


### Utilisation du format de message ICU

`gt-next` prend en charge le format de message ICU, ce qui vous permet également de mettre en forme vos variables.

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

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>
  Le format de message ICU est un moyen puissant pour formater vos variables.
  Pour en savoir plus, consultez la [documentation du format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Remarques

* La fonction `msg` sert à marquer des chaînes de caractères en vue de leur traduction.
* La traduction des chaînes de caractères avec `msg` s’effectue avant le runtime, pendant le processus de build (sauf en développement).

## Étapes suivantes

* Consultez [`useMessages`](/docs/next/api/strings/use-messages) pour traduire des chaînes de caractères.