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

title: useSetLocale
description: Cambia la configuración regional activa. Referencia de la API de useSetLocale.

---

El composable `useSetLocale` devuelve la función asíncrona del plugin instalado para establecer la configuración regional. Su comportamiento de carga y navegación depende de cómo se creó el plugin.

## Descripción general [#overview]

Llame a la función resultante con la configuración regional de destino:

```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) para obtener la configuración regional activa.

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

### Plugins reactivos

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

1. Carga un catálogo de destino no almacenado en caché mediante el loader configurado.
2. Guarda la configuración regional de destino en la cookie configurada tras cargarlo correctamente.
3. Actualiza los consumidores reactivos sin recargar la página.

Los catálogos cargados correctamente permanecen en caché. Las solicitudes simultáneas pueden finalizar en cualquier orden, pero solo la solicitud más reciente cambia la configuración regional activa. Si se rechaza la carga de su catálogo, la promesa se rechaza y la configuración regional actual y la cookie no cambian.

### Plugins de SPA en el navegador

Para el singleton que devuelve [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), el setter resuelve la configuración regional solicitada según la lista de configuraciones regionales configurada, si se proporciona una; escribe la cookie y recarga el documento. No carga el catálogo de destino en la página actual, cuya configuración regional permanece fijada hasta la recarga. La recarga permite que las llamadas a [`t()`](/docs/vue/reference/functions/t) de nivel de módulo se ejecuten de nuevo después de precargar el nuevo catálogo.

## Parámetros [#parameters]

`useSetLocale` no acepta parámetros.

## Devuelve [#returns]

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

Una función de establecimiento asíncrona con este parámetro:

| Parámetro           | Descripción                                  | Tipo     | Opcional | Predeterminado |
| ------------------- | -------------------------------------------- | -------- | -------- | -------------- |
| [`locale`](#locale) | Código de configuración regional de destino. | `string` | No       | —              |

### `locale`

**Tipo** `string` · **Obligatorio**

El código de configuración regional de destino. Un plugin reactivo de [`createGT()`](/docs/vue/reference/functions/create-gt) acepta cualquier código que pueda gestionar su loader. Cuando un plugin de [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) tiene configurada una lista de `locales`, busca coincidencias con esas configuraciones regionales y los alias configurados, y recurre a su configuración regional predeterminada cuando la solicitud no es compatible.

## Ejemplo [#example]

Espere a que se apliquen los cambios reactivos cuando el código posterior dependa de la nueva configuración regional:

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

En una SPA inicializada con [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa), la recarga del documento se inicia como parte de la llamada, así que no programes tareas en la misma página que asuman que la configuración regional de destino ya está activa.