# vue: CreateGTOptions
URL: https://generaltranslation.com/es/docs/vue/reference/types/create-gt-options.mdx
---
title: CreateGTOptions
description: Configura la configuración regional inicial, la cookie y el cargador de catálogos de un plugin de Vue aislado. Referencia de la API de CreateGTOptions.

---

Pasa este objeto a [`createGT()`](/docs/vue/reference/functions/create-gt). Sus campos se aplican a plugins reactivos del cliente y plugins del servidor con ámbito de solicitud.

## Descripción general [#overview]

```ts
type CreateGTOptions = {
  defaultLocale?: string;
  loadTranslations?: LoadTranslations;
  locale?: string;
  localeCookieName?: string;
};
```

| Opción                                   | Descripción                                                                           | Tipo                                                              | Opcional | Predeterminado                 |
| ---------------------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | -------- | ------------------------------ |
| [`defaultLocale`](#default-locale)       | Configuración regional de origen y alternativa.                                       | `string`                                                          | Sí       | `en`                           |
| [`loadTranslations`](#load-translations) | Cargador asíncrono del catálogo de destino.                                           | [`LoadTranslations`](/docs/vue/reference/types/load-translations) | Sí       | Catálogo vacío                 |
| [`locale`](#locale)                      | Configuración regional inicial explícita.                                             | `string`                                                          | Sí       | Cookie y luego `defaultLocale` |
| [`localeCookieName`](#cookie-name)       | Cookie del navegador utilizada para conservar la selección de configuración regional. | `string`                                                          | Sí       | `generaltranslation.locale`    |

## `defaultLocale` [#default-locale]

**Tipo** `string` · **Opcional** · **Predeterminado** `en`

La configuración regional del contenido de origen y la alternativa cuando no hay ninguna configuración regional explícita o guardada. Su texto de origen actúa como catálogo, por lo que el plugin nunca llama a [`loadTranslations`](/docs/vue/reference/types/load-translations) para esta configuración regional.

El valor no se canonicaliza ni está restringido por [`createGT()`](/docs/vue/reference/functions/create-gt). Usa la misma grafía en la configuración de la CLI, las rutas del cargador y la resolución de la configuración regional de la solicitud.

## `loadTranslations` [#load-translations]

**Tipo** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Opcional** · **Predeterminado** catálogo vacío

Una función de callback asíncrona que devuelve el [`TranslationCatalog`](/docs/vue/reference/types/translation-catalog) completo para una configuración regional de destino. Si se omite, cada carga para una configuración regional de destino se resuelve como `{}`, por lo que el contenido de origen permanece visible.

Los resultados correctos se almacenan en caché por plugin, y las llamadas simultáneas para una misma configuración regional comparten una promesa. Los rechazos se registran y se vuelven a lanzar sin almacenarse en caché.

## `locale` [#locale]

**Tipo** `string` · **Opcional** · **Predeterminado** cookie del navegador; después, `defaultLocale`

Establece explícitamente la configuración regional activa inicial. En el servidor, pasa la configuración regional resuelta para la solicitud actual. En el navegador, un valor explícito prevalece sobre una cookie de configuración regional desactualizada y se guarda en ella, lo que mantiene la hidratación coherente.

Si se omite en el navegador, la cookie guardada prevalece sobre `defaultLocale`. Si se omite en el servidor, se usa `defaultLocale`.

## `localeCookieName` [#cookie-name]

**Tipo** `string` · **Opcional** · **Predeterminado** `generaltranslation.locale`

Especifica el nombre de la cookie de sesión válida para toda la ruta, que se usa para conservar y leer la configuración regional activa. Reemplázalo cuando el enrutamiento o el middleware del servidor compartan otro nombre de cookie.

Las escrituras directas de cookies en el navegador son visibles para `plugin.getLocale()` y para el siguiente renderizado de Vue, pero el navegador no emite ningún evento que programe ese renderizado. Usa `plugin.setLocale()` o [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) para realizar cambios reactivos.

## Ejemplo [#example]

```ts
import type { CreateGTOptions } from 'gt-vue';

const options: CreateGTOptions = {
  defaultLocale: 'en',
  locale: requestLocale,
  localeCookieName: 'my-app.locale',
  loadTranslations: async (locale) =>
    (await import(`./_gt/${locale}.json`)).default,
};
```

Cree un objeto de opciones y un plugin independientes para cada solicitud al servidor. Compartir el estado del plugin o una caché mutable del catálogo fuera del plugin puede filtrar datos específicos de la configuración regional entre solicitudes.