# vue: CreateGTOptions
URL: https://generaltranslation.com/it/docs/vue/reference/types/create-gt-options.mdx
---

title: CreateGTOptions
description: Configura l'impostazione regionale iniziale, il cookie e il loader del catalogo di un plugin Vue isolato. Riferimento API per CreateGTOptions.

---

Passa questo oggetto a [`createGT()`](/docs/vue/reference/functions/create-gt). I suoi campi si applicano ai plugin client reattivi e ai plugin server con ambito di richiesta.

## Panoramica [#overview]

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

| Opzione                                  | Descrizione                                                                        | Tipo                                                              | Facoltativo | Predefinito                 |
| ---------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------- | --------------------------- |
| [`defaultLocale`](#default-locale)       | Impostazione regionale sorgente e di fallback.                                     | `stringa`                                                          | Sì          | `en`                        |
| [`loadTranslations`](#load-translations) | Loader asincrono del catalogo di destinazione.                                     | [`LoadTranslations`](/docs/vue/reference/types/load-translations) | Sì          | Catalogo vuoto              |
| [`locale`](#locale)                      | Impostazione regionale iniziale esplicita.                                         | `stringa`                                                          | Sì          | Cookie, poi `defaultLocale` |
| [`localeCookieName`](#cookie-name)       | Cookie del browser usato per salvare la selezione dell'impostazione regionale. | `stringa`                                                          | Sì          | `generaltranslation.locale` |

## `defaultLocale` [#default-locale]

**Tipo** `stringa` · **Facoltativo** · **Predefinito** `en`

L'impostazione regionale dei contenuti sorgente e il fallback quando non è presente un'impostazione regionale esplicita o salvata. Il relativo testo sorgente funge da catalogo, quindi il plugin non chiama mai [`loadTranslations`](/docs/vue/reference/types/load-translations) per questa impostazione regionale.

Il valore non viene canonicalizzato né limitato da [`createGT()`](/docs/vue/reference/functions/create-gt). Usa la stessa grafia nella configurazione CLI, nei percorsi del loader e nella risoluzione dell'impostazione regionale della richiesta.

## `loadTranslations` [#load-translations]

**Tipo** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Facoltativo** · **Predefinito** catalogo vuoto

Un callback asincrono che restituisce il [`TranslationCatalog`](/docs/vue/reference/types/translation-catalog) completo per un'impostazione regionale di destinazione. Se omesso, ogni caricamento per la destinazione restituisce `{}`, quindi il contenuto sorgente rimane visibile.

I risultati completati correttamente vengono memorizzati nella cache per plugin e le chiamate concorrenti per la stessa impostazione regionale condividono una promise. I rifiuti vengono registrati e rilanciati senza essere memorizzati nella cache.

## `locale` [#locale]

**Tipo** `stringa` · **Facoltativo** · **Predefinito** cookie del browser, quindi `defaultLocale`

Imposta esplicitamente l'impostazione regionale attiva iniziale. Sul server, passa l'impostazione regionale risolta per la richiesta corrente. Nel browser, un valore esplicito ha la precedenza su un cookie dell'impostazione regionale non aggiornato e viene riscritto nel cookie, mantenendo coerente l'idratazione.

Se omesso nel browser, il cookie salvato ha la precedenza su `defaultLocale`. Se omesso sul server, viene utilizzato `defaultLocale`.

## `localeCookieName` [#cookie-name]

**Tipo** `stringa` · **Facoltativo** · **Predefinito** `generaltranslation.locale`

Specifica il cookie di sessione valido per l'intero percorso, usato per memorizzare e leggere l'impostazione regionale attiva. Sostituiscilo quando il routing o il middleware del server utilizza un nome di cookie diverso.

Le scritture dirette dei cookie del browser sono visibili a `plugin.getLocale()` e al successivo render di Vue, ma il browser non emette un evento che pianifichi tale render. Usa `plugin.setLocale()` o [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) per apportare modifiche reattive.

## Esempio [#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,
};
```

Crea un oggetto options e un plugin distinti per ogni richiesta al server. Condividere lo stato del plugin o una cache modificabile del catalogo all'esterno del plugin può far trapelare dati specifici dell'impostazione regionale tra le richieste.