> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer Radar dans une application Vue

> Ajoutez le script Radar à une application Vue via son fichier HTML, ou chargez-le avec useHead, vue-meta ou un composable quand la clé vient d'une variable d'environnement.

Dans une application Vue, le moyen le plus simple d'installer Radar est de coller le script dans le fichier HTML qui héberge votre application. Tous les écrans de l'application sont servis depuis ce seul fichier : le script se charge donc partout. Remplacez `pk_xxxx` par votre clé de projet.

Ce fichier est `index.html` à la racine d'un projet Vite, et `public/index.html` dans un projet Vue CLI.

```html index.html theme={null}
<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vue App</title>

    <script
      async
      src="https://taap.it/scripts/tracker.js"
      data-project="pk_xxxx"
      data-track-outbound="true"
      data-track-forms="true"
    ></script>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>
```

Pour savoir à quoi sert chaque attribut, consultez [le fonctionnement du script](https://docs.taap.it/fr/radar/how-the-script-works.md).

## Variante : votre gestionnaire de head

Si votre application gère déjà le head du document avec une bibliothèque, ajoutez-y le script. Dans les deux exemples, le script n'est pas ajouté quand aucune clé n'est définie.

> [tab] Vue 3 (useHead)
>
> Avec `@unhead/vue` déjà configuré dans votre application, appelez `useHead` dans votre composant racine :
>
> ```vue src/App.vue theme={null}
> <script setup lang="ts">
> import { useHead } from "@unhead/vue";
>
> const projectKey = import.meta.env.VITE_RADAR_PROJECT_KEY;
>
> useHead({
>   script: projectKey
>     ? [
>         {
>           src: "https://taap.it/scripts/tracker.js",
>           async: true,
>           "data-project": projectKey,
>           "data-track-outbound": "true",
>           "data-track-forms": "true",
>         },
>       ]
>     : [],
> });
> </script>
>
> <template>
>   <RouterView />
> </template>
> ```

> [tab] Vue 2 (vue-meta)
>
> Avec `vue-meta`, déclarez le script dans l'option `metaInfo` de votre composant racine :
>
> ```js src/App.vue (script block) theme={null}
> export default {
>   name: "App",
>   metaInfo() {
>     const projectKey = process.env.VUE_APP_RADAR_PROJECT_KEY;
>
>     return {
>       script: projectKey
>         ? [
>             {
>               src: "https://taap.it/scripts/tracker.js",
>               async: true,
>               "data-project": projectKey,
>               "data-track-outbound": "true",
>               "data-track-forms": "true",
>             },
>           ]
>         : [],
>     };
>   },
> };
> ```

## Variante : le charger depuis un composable

Un composable peut ajouter le script à la page au montage de votre composant racine. Il ne fait rien quand la clé est absente ou quand le script est déjà sur la page.

```ts src/composables/useRadar.ts theme={null}
import { onMounted } from "vue";

export function useRadar(projectKey?: string) {
  onMounted(() => {
    if (!projectKey) return;
    if (document.querySelector("script[data-project]")) return;

    const script = document.createElement("script");
    script.src = "https://taap.it/scripts/tracker.js";
    script.async = true;
    script.setAttribute("data-project", projectKey);
    script.setAttribute("data-track-outbound", "true");
    script.setAttribute("data-track-forms", "true");

    document.head.appendChild(script);
  });
}
```

Appelez-le une seule fois, dans votre composant racine :

```vue src/App.vue theme={null}
<script setup lang="ts">
import { useRadar } from "./composables/useRadar";

useRadar(import.meta.env.VITE_RADAR_PROJECT_KEY);
</script>

<template>
  <RouterView />
</template>
```

## Ne pas utiliser la clé en développement

Avec un gestionnaire de head ou le composable, stockez la clé dans un fichier d'environnement et laissez-la vide pour le développement. Sans clé, le script n'est pas ajouté à la page : Radar ne se charge donc pas pendant que vous développez.

```bash .env theme={null}
VITE_RADAR_PROJECT_KEY=
```

```bash .env.production theme={null}
VITE_RADAR_PROJECT_KEY=pk_xxxx
```

Vite n'expose que les variables dont le nom commence par `VITE_`. Avec Vue CLI, nommez la variable `VUE_APP_RADAR_PROJECT_KEY` et lisez-la avec `process.env.VUE_APP_RADAR_PROJECT_KEY`.

## Vérifier que tout fonctionne

Déployez votre site, ouvrez la version publiée, chargez deux pages et cliquez sur un lien. Le premier événement doit arriver dans votre tableau de bord Radar en quelques secondes. Si rien n'arrive, suivez les étapes de [vérification de votre installation](https://docs.taap.it/fr/help/radar/check-your-installation.md). Quand la balise est ajoutée par JavaScript au lieu d'être écrite dans le HTML, elle n'apparaît pas dans le code source brut de la page : cherchez plutôt `tracker.js` dans le panneau Éléments des outils de développement de votre navigateur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.