# Vue: CreateGTOptions
URL: https://generaltranslation.com/es/docs/vue/reference/types/create-gt-options.mdx
Docs index: https://generaltranslation.com/llms.txt
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 = {
  customMapping?: CustomMapping;
  defaultLocale?: string;
  loadTranslations?: LoadTranslations;
  locale?: string;
  localeCookieName?: string;
};
```

| Opción                                   | Descripción                                                                           | Tipo                                                                  | Opcional | Predeterminado                 |
| ---------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | ------------------------------ |
| [`customMapping`](#custom-mapping)       | Alias de configuración regional para el formateo y la selección de plurales.          | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | Ninguno                        |
| [`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`    |

## `customMapping` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Opcional** · **Predeterminado** ninguno

Alias de configuración regional que se usan para el formateo según la configuración regional y la selección de plurales. Un objeto de mapeo con un `code` válido cambia la configuración regional que se pasa a los formateadores de `Intl` y a las reglas de plural.

La carga del catálogo y la cookie de configuración regional conservan el alias original. Por ejemplo, definir `pirate: { code: 'fr-FR' }` carga el catálogo `pirate` y conserva `pirate`, pero formatea los valores con las reglas del francés.

## `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 = {
  customMapping: {
    pirate: { code: 'fr-FR' },
  },
  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.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.