# vue: useSetLocale
URL: https://generaltranslation.com/it/docs/vue/reference/composables/use-set-locale.mdx
---

title: useSetLocale
description: Modifica l'impostazione regionale attiva. Riferimento API di useSetLocale.

---

Il composable `useSetLocale` restituisce la funzione asincrona del plugin installato per impostare l'impostazione regionale. Il comportamento relativo al caricamento e alla navigazione dipende da come è stato creato il plugin.

## Panoramica [#overview]

Chiama la funzione restituita passando l'impostazione regionale di destinazione:

```vue
<script setup lang="ts">
import { useSetLocale } from 'gt-vue';

const setLocale = useSetLocale();
</script>

<template>
  <button @click="setLocale('fr')">Français</button>
</template>
```

Usa [`useLocale()`](/docs/vue/reference/composables/use-locale) per ottenere l&#39;impostazione regionale attiva.

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

### Plugin reattivi

Per un plugin [`createGT()`](/docs/vue/reference/functions/create-gt), il setter:

1. Carica un catalogo di destinazione non memorizzato nella cache tramite il loader configurato.
2. Salva l&#39;impostazione regionale di destinazione nel cookie configurato dopo il corretto completamento del caricamento.
3. Aggiorna i consumer reattivi senza ricaricare la pagina.

I cataloghi caricati correttamente rimangono nella cache. Le richieste simultanee possono completarsi in qualsiasi ordine, ma solo l&#39;ultima modifica l&#39;impostazione regionale attiva. Se il caricamento del relativo catalogo viene rifiutato, anche la promise viene rifiutata e l&#39;impostazione regionale attuale e il cookie rimangono invariati.

### Plugin SPA del browser

Per il singleton restituito da [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), il setter risolve l&#39;impostazione regionale richiesta in base all&#39;elenco di impostazioni regionali configurato, se presente, scrive il cookie e ricarica il documento. Non carica il catalogo di destinazione nella pagina corrente, la cui impostazione regionale rimane bloccata fino al ricaricamento. Il ricaricamento consente di eseguire nuovamente le chiamate [`t()`](/docs/vue/reference/functions/t) a livello di modulo dopo il precaricamento del nuovo catalogo.

## Parametri [#parameters]

`useSetLocale` non accetta parametri.

## Restituisce [#returns]

**Tipo** `(locale: string) => Promise<void>`

Setter asincrono con il seguente parametro:

| Parametro           | Descrizione                                             | Tipo     | Facoltativo | Predefinito |
| ------------------- | ------------------------------------------------------- | -------- | ----------- | ----------- |
| [`locale`](#locale) | Codice dell&#39;impostazione regionale di destinazione. | `string` | No          | —           |

### `locale`

**Tipo** `string` · **Obbligatorio**

Il codice dell&#39;impostazione regionale di destinazione. Un plugin reattivo [`createGT()`](/docs/vue/reference/functions/create-gt) accetta qualsiasi codice gestibile dal proprio loader. Quando un plugin [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) ha un elenco `locales` configurato, trova una corrispondenza con tali impostazioni regionali e con gli alias configurati; se la richiesta non è supportata, usa l&#39;impostazione regionale predefinita.

## Esempio [#example]

Attendi l&#39;applicazione delle modifiche reattive quando il codice successivo dipende dalla nuova impostazione regionale:

```vue title="LocaleSelect.vue"
<script setup lang="ts">
import { useLocale, useSetLocale } from 'gt-vue';

const locale = useLocale();
const setLocale = useSetLocale();

async function changeLocale(event: Event) {
  const target = event.target as HTMLSelectElement;
  await setLocale(target.value);
}
</script>

<template>
  <select :value="locale" @change="changeLocale">
    <option value="en">English</option>
    <option value="fr">Français</option>
    <option value="ja">日本語</option>
  </select>
</template>
```

In una SPA inizializzata con [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), il ricaricamento del documento inizia durante la chiamata; non pianificare quindi operazioni sulla stessa pagina che presuppongono che l&#39;impostazione regionale di destinazione sia già attiva.