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

title: CreateGTOptions
description: Configurez le paramètre régional initial, le cookie et le loader de catalogue d'un plugin Vue isolé. Référence de l'API CreateGTOptions.

---

Transmettez cet objet à [`createGT()`](/docs/vue/reference/functions/create-gt). Ses champs s'appliquent aux plugins clients réactifs et aux plugins serveur dont la portée est limitée à la requête.

## Vue d’ensemble [#overview]

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

| Option                                   | Description                                                                       | Type                                                              | Facultatif | Par défaut                   |
| ---------------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------- | ---------------------------- |
| [`defaultLocale`](#default-locale)       | Paramètre régional source et de secours.                                          | `string`                                                          | Oui        | `en`                         |
| [`loadTranslations`](#load-translations) | Loader asynchrone du catalogue cible.                                           | [`LoadTranslations`](/docs/vue/reference/types/load-translations) | Oui        | Catalogue vide               |
| [`locale`](#locale)                      | Paramètre régional initial explicite.                                             | `string`                                                          | Oui        | Cookie, puis `defaultLocale` |
| [`localeCookieName`](#cookie-name)       | Cookie du navigateur utilisé pour enregistrer la sélection du paramètre régional. | `string`                                                          | Oui        | `generaltranslation.locale`  |

## `defaultLocale` [#default-locale]

**Type** `string` · **Facultatif** · **Par défaut** `en`

Le paramètre régional du contenu source et le contenu de secours lorsqu’aucun paramètre régional explicite ou enregistré n’est défini. Son texte source sert de catalogue ; le plugin n’appelle donc jamais [`loadTranslations`](/docs/vue/reference/types/load-translations) pour ce paramètre régional.

La valeur n’est ni mise sous forme canonique ni restreinte par [`createGT()`](/docs/vue/reference/functions/create-gt). Utilisez la même orthographe dans votre configuration CLI, les chemins des loaders et la résolution du paramètre régional des requêtes.

## `loadTranslations` [#load-translations]

**Type** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Facultatif** · **Par défaut** : catalogue vide

Un callback asynchrone qui renvoie l’intégralité du [`TranslationCatalog`](/docs/vue/reference/types/translation-catalog) pour un paramètre régional cible. S’il est omis, chaque chargement de cible se résout en `{}`, de sorte que le contenu source reste visible.

Les résultats concluants sont mis en cache pour chaque plugin, et les appels simultanés pour un même paramètre régional partagent une promesse. Les rejets sont consignés et relancés, sans être mis en cache.

## `paramètre régional` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** cookie du navigateur, puis `defaultLocale`

Définit explicitement le paramètre régional actif initial. Sur le serveur, transmettez le paramètre régional résolu pour la requête en cours. Dans le navigateur, une valeur explicite prévaut sur un cookie de paramètre régional obsolète et y est enregistrée, afin de garantir la cohérence de l’hydratation.

S’il est omis dans le navigateur, le cookie enregistré prévaut sur `defaultLocale`. S’il est omis sur le serveur, `defaultLocale` est utilisé.

## `localeCookieName` [#cookie-name]

**Type** `string` · **Facultatif** · **Par défaut** `generaltranslation.locale`

Définit le nom du cookie de session valable sur l’ensemble du chemin, utilisé pour conserver et lire le paramètre régional actif. Remplacez-le lorsque le routage ou le middleware serveur utilise un autre nom de cookie.

Les écritures directes de cookies dans le navigateur sont visibles par `plugin.getLocale()` et prises en compte lors du prochain affichage Vue, mais le navigateur n’émet aucun événement pour planifier cet affichage. Utilisez `plugin.setLocale()` ou [`useSetLocale()`](/docs/vue/reference/composables/use-set-locale) pour effectuer des modifications réactives.

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

Créez un objet d’options et un plugin distincts pour chaque requête au serveur. Le partage de l’état du plugin ou d’un cache de catalogue modifiable en dehors du plugin peut entraîner la divulgation de données propres à un paramètre régional entre les requêtes.