# vue: InitializeGTSPAOptions URL: https://generaltranslation.com/fr/docs/vue/reference/types/initialize-gt-spa-options.mdx --- title: InitializeGTSPAOptions description: Configure le document unique réservé au navigateur utilisé pour les traductions préchargées au niveau du module. Référence de l’API d’InitializeGTSPAOptions. --- Passez cet objet à [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa). Il étend [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options) avec la liste des paramètres régionaux et les alias pouvant être lus directement depuis `gt.config.json`. ## Vue d’ensemble [#overview] ```ts type InitializeGTSPAOptions = CreateGTOptions & { customMapping?: CustomMapping; locales?: readonly string[]; }; ``` | Option | Description | Type | Facultatif | Par défaut | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | ---------------------------- | | [`defaultLocale`](#defaultlocale) | Paramètre régional source et de secours. | `string` | Oui | `en` | | [`loadTranslations`](#loadtranslations) | Chargeur asynchrone du catalogue cible. | [`LoadTranslations`](/docs/vue/reference/types/load-translations) | Oui | Catalogue vide | | [`locale`](#locale) | Paramètre régional initial explicitement défini. | `string` | Oui | Cookie, puis `defaultLocale` | | [`localeCookieName`](#localecookiename) | Cookie utilisé pour mémoriser le paramètre régional sélectionné. | `string` | Oui | `generaltranslation.locale` | | [`customMapping`](#custommapping) | Objet de mapping des valeurs `code` utilisées pour la correspondance des paramètres régionaux et la résolution du paramètre régional du formateur. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui | Aucun | | [`locales`](#locales) | Paramètres régionaux cibles pris en charge par cette SPA. | `readonly string[]` | Oui | Sans restriction | ## Options communes [#shared-options] ### `defaultLocale` **Type** `string` · **Facultatif** · **Par défaut** `en` Le paramètre régional source et de secours. Il fait automatiquement partie des paramètres régionaux pris en charge et utilise le contenu source au lieu d’appeler le loader. ### `loadTranslations` **Type** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Facultatif** · **Par défaut** : catalogue vide Charge l’intégralité du catalogue cible. L’initialisation de la SPA attend que le catalogue du paramètre régional actif soit chargé avant de se terminer. En cas de rejet, un diagnostic est consigné, l’initialisation est rejetée et un appel d’initialisation ultérieur peut réessayer. ### `locale` **Type** `string` · **Facultatif** · **Par défaut** cookie du navigateur, puis `defaultLocale` Paramètre régional initial explicitement défini. Il prévaut sur le cookie, est résolu à partir de `locales` et est conservé. La page actuelle verrouille alors ce paramètre régional résolu jusqu’au rechargement du document. ### `localeCookieName` **Type** `string` · **Facultatif** · **Par défaut** `generaltranslation.locale` Désigne le cookie de session valable pour l’ensemble du chemin, lu lors de l’initialisation et écrit avant le rechargement de la SPA avec un autre paramètre régional. ## Options pour les SPA [#spa-options] ### `customMapping` **Type** `Record>` · **Facultatif** · **Par défaut** aucun Déclare les alias de paramètres régionaux de votre configuration General Translation. La SPA utilise un `code` valide dans un objet de mapping pour la correspondance avec les paramètres régionaux pris en charge et comme paramètre régional de formatage pour le contenu enrichi et les composants de formatage. Les valeurs de type chaîne et les autres propriétés d'un objet de mapping ne sont pas lues par `gt-vue`. Les chemins du loader reçoivent toujours l'orthographe de l'entrée configurée `defaultLocale` ou `locales` qui a établi la correspondance. ### `locales` **Type** `readonly string[]` · **Facultatif** · **Par défaut** sans restriction Paramètres régionaux cibles déclarés par l’application. L’initialiseur déduplique `[defaultLocale, ...locales]`, met les requêtes en correspondance sans tenir compte de la casse et par résolution canonique du paramètre régional, puis se replie sur `defaultLocale` lorsqu’aucun paramètre régional configuré ne correspond. Lorsque cette option est omise, les codes de langue autres que celui par défaut ne sont pas rejetés. Les variantes de casse équivalentes ou les alias de `defaultLocale` sont toujours résolus vers l’orthographe par défaut configurée. ## Comportement du document unique [#singleton] Seules les options de la première tentative d’initialisation permettent de créer le runtime à l’échelle de la page. Les appels simultanés partagent cette tentative. Une fois celle-ci réussie, les appels ultérieurs renvoient le plugin existant et n’appliquent pas les nouvelles valeurs d’options. Si la première tentative échoue, son entrée de document unique en cours est supprimée et un appel ultérieur peut réessayer avec de nouvelles options. ## Exemple [#example] ```ts title="src/index.ts" import { initializeGTSPA } from 'gt-vue'; import type { InitializeGTSPAOptions } from 'gt-vue'; import gtConfig from '../gt.config.json'; import loadTranslations from './loadTranslations'; const options: InitializeGTSPAOptions = { defaultLocale: gtConfig.defaultLocale, locales: gtConfig.locales, customMapping: gtConfig.customMapping, loadTranslations, }; async function bootstrap() { const gt = await initializeGTSPA(options); const { mount } = await import('./main'); mount(gt); } void bootstrap().catch((error: unknown) => { console.error(error); }); ``` Cette API est réservée au navigateur. Pour le rendu côté serveur, utilisez [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options), avec une portée limitée à la requête, avec [`createGT()`](/docs/vue/reference/functions/create-gt).