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

title: useLocale
description: Obtiene la configuración regional activa. Referencia de la API de useLocale.

---

El composable `useLocale` devuelve la configuración regional activa del plugin instalado como una ref de Vue de solo lectura. El valor es un código de configuración regional, como `en` o `fr-CA`.

## Resumen [#overview]

Las plantillas de Vue desenvuelven automáticamente la ref:

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

const locale = useLocale();
</script>

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

En el código del script, lee `locale.value`.

## Cómo funciona [#how-it-works]

* Con un plugin [`createGT()`](/docs/vue/reference/functions/create-gt), la ref se actualiza tras cambiar correctamente la configuración regional, sin recargar la página.
* Con un plugin devuelto por [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), la configuración regional permanece fijada para la página actual. [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) guarda la nueva configuración regional y recarga el documento; después, queda disponible en la siguiente inicialización de la página.
* Llamar al composable sin un plugin instalado genera un error.

La cookie de configuración regional del navegador no es una fuente reactiva de eventos. Cambia la configuración regional mediante [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale), en lugar de escribir directamente en `document.cookie`.

## Parámetros [#parameters]

`useLocale` no acepta parámetros.

## Devuelve [#returns]

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

Una ref de solo lectura que contiene la configuración regional activa. Vue la desenvuelve en las plantillas; el código de JavaScript y TypeScript usa `.value`.

```ts
const locale = useLocale();

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

## Ejemplo [#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>
```