# vue: useMessages
URL: https://generaltranslation.com/fr/docs/vue/reference/composables/use-messages.mdx
---

title: useMessages
description: Résout les chaînes enregistrées avec msg dans le paramètre régional actif. Référence de l’API useMessages.

---

Le composable `useMessages` renvoie un résolveur synchrone pour les chaînes enregistrées par [`msg()`](/docs/vue/reference/functions/msg). Il accepte également les chaînes source ordinaires et préserve les valeurs nulles ou indéfinies.

## Vue d’ensemble [#overview]

Enregistrez le texte source au niveau du module, puis résolvez chaque chaîne enregistrée dans un composant :

```ts title="src/messages.ts"
import { msg } from 'gt-vue';

export const savedMessage = msg('Your preferences are saved.', {
  $context: 'Settings confirmation',
});
```

```vue title="SettingsStatus.vue"
<script setup lang="ts">
import { useMessages } from 'gt-vue';
import { savedMessage } from './messages';

const m = useMessages();
</script>

<template>
  <p>{{ m(savedMessage) }}</p>
</template>
```

## Fonctionnement [#how-it-works]

* **Messages enregistrés.** [`msg()`](/docs/vue/reference/functions/msg) enregistre la source en vue de son extraction. Lorsqu’il reçoit des options, il encode les métadonnées de source et de contexte, qui prévalent sur les options fournies au point d’appel ; sans options, il renvoie la chaîne source inchangée.
* **Chaînes brutes.** Une chaîne ordinaire est recherchée comme lors d’un appel à [`useGT()`](/docs/vue/reference/composables/use-gt) et peut fournir un `$context` au point d’appel.
* **Transmission des valeurs nulles.** `null` renvoie `null` et `undefined` renvoie `undefined`.
* **Contenu de secours de la source.** Une entrée de catalogue manquante ou incompatible renvoie la chaîne source d’origine.
* **Chaînes simples uniquement.** Les accolades restent littérales ; aucun formatage ICU ni aucune interpolation n’est effectué.

Appelez le résolveur depuis un modèle, un `computed` ou un autre effet réactif lorsqu’il doit se mettre à jour après un changement de catalogue ou de paramètre régional dans [`createGT()`](/docs/vue/reference/functions/create-gt). Une valeur résolue une seule fois lors de l’initialisation est un instantané sous forme de simple chaîne de caractères. Une SPA exécutée dans le navigateur et initialisée avec [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) précharge son catalogue initial et recrée les instantanés après son rechargement consécutif à un changement de paramètre régional.

## Paramètres [#parameters]

`useMessages` n’accepte aucun paramètre.

## Renvoie [#returns]

**Type** `<T extends string | null | undefined>(message: T, options?: GTStringOptions) => T extends string ? string : T`

Un résolveur synchrone acceptant les paramètres suivants :

| Paramètre             | Description                                                           | Type                                                             | Facultatif | Par défaut |
| --------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------- | ---------- |
| [`message`](#message) | Message enregistré, chaîne source brute ou valeur nulle ou indéfinie. | `string \| null \| undefined`                                    | Non        | —          |
| [`options`](#options) | Contexte d&#39;une chaîne source brute non encodée.                   | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Oui        | `{}`       |

### `message`

**Type** `string | null | undefined` · **Obligatoire**

Une chaîne renvoyée par [`msg()`](/docs/vue/reference/functions/msg), une chaîne source brute statique, `null` ou `undefined`. Si [`msg()`](/docs/vue/reference/functions/msg) a enregistré un tableau, résolvez chaque élément séparément.

### `options`

**Type** [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) · **facultatif** · **Par défaut** `{}`

Le seul champ pris en charge est `$context?: string`. Il s’applique à une chaîne source brute. Le contexte déjà encodé par [`msg()`](/docs/vue/reference/functions/msg) prévaut.

## Exemples [#examples]

Résoudre un message enregistré qui peut être nul sans vérification distincte :

```vue title="StatusMessage.vue"
<script setup lang="ts">
import { useMessages } from 'gt-vue';

defineProps<{ encodedMessage: string | null }>();
const m = useMessages();
</script>

<template>
  <p>{{ m(encodedMessage) }}</p>
</template>
```

Résoudre une chaîne brute avec un contexte :

```vue
<p>{{ m('Open', { $context: 'Adjective: an open issue' }) }}</p>
```