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

title: useMessages
description: Risolve le stringhe registrate con msg nell'impostazione regionale attiva. Riferimento API di useMessages.

---

Il composable `useMessages` restituisce un resolver sincrono per le stringhe registrate con [`msg()`](/docs/vue/reference/functions/msg). Accetta anche normali stringhe sorgente e mantiene i valori nullish.

## Panoramica [#overview]

Registra il testo sorgente a livello di modulo, quindi risolvi ogni stringa registrata all'interno di un componente:

```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>
```

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

* **Messaggi registrati.** [`msg()`](/docs/vue/reference/functions/msg) registra il sorgente per l&#39;estrazione. Quando riceve opzioni, codifica i metadati del sorgente e del contesto, che hanno la precedenza sulle opzioni nel punto di chiamata; senza opzioni, restituisce la stringa sorgente invariata.
* **Stringhe non elaborate.** Una normale stringa viene cercata come se fosse una chiamata a [`useGT()`](/docs/vue/reference/composables/use-gt) e può fornire `$context` nel punto di chiamata.
* **Passaggio di valori nulli.** `null` restituisce `null` e `undefined` restituisce `undefined`.
* **Fallback del sorgente.** Una voce di catalogo mancante o incompatibile restituisce la stringa sorgente originale.
* **Solo stringhe semplici.** Le parentesi graffe rimangono letterali; non vengono eseguite né la formattazione ICU né l&#39;interpolazione.

Chiama il resolver da un template, da `computed` o da un altro effetto reattivo quando deve aggiornarsi in seguito a una modifica del catalogo o dell&#39;impostazione regionale di [`createGT()`](/docs/vue/reference/functions/create-gt). Un valore risolto una sola volta durante il setup è uno snapshot di una semplice stringa. Una SPA nel browser inizializzata con [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) precarica il catalogo iniziale e ricrea gli snapshot dopo il ricaricamento dovuto alla modifica dell&#39;impostazione regionale.

## Parametri [#parameters]

`useMessages` non accetta parametri.

## Restituisce [#returns]

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

Un resolver sincrono con i seguenti parametri:

| Parametro             | Descrizione                                                            | Tipo                                                             | Facoltativo | Predefinito |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| [`message`](#message) | Messaggio registrato, stringa sorgente non elaborata o valore nullish. | `string \| null \| undefined`                                    | No          | —           |
| [`options`](#options) | Contesto per una stringa sorgente non elaborata e non codificata.      | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Sì          | `{}`        |

### `message`

**Tipo** `string | null | undefined` · **Obbligatorio**

Una singola stringa restituita da [`msg()`](/docs/vue/reference/functions/msg), una stringa sorgente statica non elaborata, `null` o `undefined`. Se [`msg()`](/docs/vue/reference/functions/msg) ha registrato un array, risolvi ciascun elemento separatamente.

### `options`

**Tipo** [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) · **Facoltativo** · **Predefinito** `{}`

L&#39;unico campo supportato è `$context?: string`. Si applica a una stringa sorgente non elaborata. Il contesto già codificato tramite [`msg()`](/docs/vue/reference/functions/msg) ha la precedenza.

## Esempi [#examples]

Risolvi un messaggio registrato che può essere null senza un controllo separato:

```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>
```

Risolvi una stringa non elaborata con il contesto:

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