# vue: MessagesFunction
URL: https://generaltranslation.com/fr/docs/vue/reference/types/messages-function.mdx
---

title: MessagesFunction
description: Résout les messages enregistrés, les chaînes brutes et les valeurs nulles du catalogue actif. Référence API de MessagesFunction.

---

[`useMessages()`](/docs/vue/reference/composables/use-messages) renvoie ce callback. Il décode les valeurs créées par [`msg()`](/docs/vue/reference/functions/msg) et accepte également une chaîne source ordinaire.

## Vue d’ensemble [#overview]

```ts
type MessagesFunction = <T extends string | null | undefined>(
  message: T,
  options?: GTStringOptions
) => T extends string ? string : T;
```

| Paramètre             | Description                                                 | Type                                                             | Facultatif | Par défaut |
| --------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------- | ---------- | ---------- |
| [`message`](#message) | Message encodé, chaîne source brute, `null` ou `undefined`. | `T extends string \| null \| undefined`                          | Non        | —          |
| [`options`](#options) | Contexte associé à une chaîne source brute.                 | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Oui        | `{}`       |

## Paramètres [#parameters]

### `message`

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

Passez une valeur renvoyée par [`msg()`](/docs/vue/reference/functions/msg), une chaîne source ordinaire ou une valeur nullable. Les chaînes encodées contiennent leur source d’origine, leur hachage et un `$context` facultatif.

### `options`

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

Pour une chaîne brute, `$context` participe au hachage du catalogue. Pour une valeur encodée, les métadonnées stockées par [`msg()`](/docs/vue/reference/functions/msg) priment, et les options fournies sur le site d’appel sont ignorées.

## Valeur de retour [#returns]

| Entrée      | Type de retour | Comportement                                                               |
| ----------- | -------------- | -------------------------------------------------------------------------- |
| `string`    | `string`       | Renvoie la traduction du catalogue ou le contenu de secours source décodé. |
| `null`      | `null`         | Renvoie `null` inchangé.                                                   |
| `undefined` | `undefined`    | Renvoie `undefined` inchangé.                                              |

Le générique conditionnel préserve les types d’entrée nullish, ce qui permet aux messages facultatifs de passer sans nécessiter de garde distincte.

## Résolution [#resolution]

Pour un message encodé, le callback décode la source stockée, le `$context` et le hachage précalculé avant d&#39;effectuer la recherche. Pour une chaîne ordinaire, il calcule le hachage à partir de la chaîne et du `$context` au site d&#39;appel.

Dans les deux cas, une valeur de type chaîne est requise dans le catalogue actif. Les entrées absentes ou qui ne sont pas des chaînes renvoient le texte source. Aucun formatage ICU ni aucune interpolation n&#39;est effectué ; les accolades restent littérales.

Appelez le callback depuis un modèle Vue, une valeur calculée ou un effet réactif si le résultat doit être mis à jour après qu&#39;un plugin [`createGT()`](/docs/vue/reference/functions/create-gt) a chargé un catalogue ou modifié le paramètre régional.

## Exemple [#example]

```vue title="src/PageTitle.vue"
<script setup lang="ts">
import { msg, useMessages } from 'gt-vue';

const title = msg('Settings', { $context: 'page title' });
const m = useMessages();
</script>

<template>
  <h1>{{ m(title) }}</h1>
</template>
```