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

title: useLocale
description: Legge l'impostazione regionale attiva. Riferimento API di useLocale.

---

Il composable `useLocale` restituisce l'impostazione regionale attiva del plugin installato come ref Vue readonly. Il valore è un codice locale, ad esempio `en` o `fr-CA`.

## Panoramica [#overview]

I template Vue dereferenziano automaticamente il ref:

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

const locale = useLocale();
</script>

<template>
  <p>Current locale: {{ locale }}</p>
</template>
```

Nel codice dello script, leggi `locale.value`.

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

* Con un plugin [`createGT()`](/docs/vue/reference/functions/create-gt), il ref si aggiorna dopo una modifica dell&#39;impostazione regionale riuscita, senza ricaricare la pagina.
* Con un plugin restituito da [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), l&#39;impostazione regionale resta fissata per la pagina corrente. [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) salva la nuova impostazione regionale e ricarica il documento; la successiva inizializzazione della pagina la rende quindi disponibile.
* Chiamare il composable senza un plugin installato genera un errore.

Il cookie dell&#39;impostazione regionale del browser non è una sorgente reattiva di eventi. Modifica l&#39;impostazione regionale tramite [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) anziché scrivere direttamente in `document.cookie`.

## Parametri [#parameters]

`useLocale` non accetta parametri.

## Restituisce [#returns]

**Tipo** `Readonly<Ref<string>>`

Una ref di sola lettura contenente l&#39;impostazione regionale attiva. Vue ne esegue l&#39;unwrapping nei template; il codice JavaScript e TypeScript usa `.value`.

```ts
const locale = useLocale();

console.log(locale.value);
```

## Esempio [#example]

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

const locale = useLocale();
const language = computed(() => locale.value.split('-')[0]);
</script>

<template>
  <p>Locale: {{ locale }}</p>
  <p>Language: {{ language }}</p>
</template>
```