Formations — 1 037 leçons en français

Accueil › Vue.js › Routes et paramètres

Routes et paramètres

Vue Routerintermediaire

Une application Vue tient sur une seule page HTML. Le routeur est ce qui lui donne plusieurs URL, et donc des pages partageables, rechargeables et navigables au bouton Précédent.

// src/router/index.ts
import { createRouter, createWebHistory } from 'vue-router'
import Accueil from '@/views/Accueil.vue'

export const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/', name: 'accueil', component: Accueil },
    { path: '/produits/:id', name: 'produit', component: () => import('@/views/Produit.vue') },
  ],
})

Le routeur s'installe comme un plugin, avec app.use(router). Deux composants suffisent ensuite. <RouterView /> marque l'endroit où le composant de la route courante est rendu. <RouterLink> produit un lien qui change l'URL sans recharger la page.

<template>
  <nav>
    <RouterLink to="/">Accueil</RouterLink>
    <RouterLink :to="{ name: 'produit', params: { id: 12 } }">Produit 12</RouterLink>
  </nav>
  <RouterView />
</template>

Dans un composant, deux composables donnent accès au routage. useRoute() renvoie la route courante, un objet réactif qu'on lit : params, query, hash, meta. useRouter() renvoie l'instance, celle avec laquelle on navigue : router.push(...), router.replace(...), router.back().

La distinction à retenir dès maintenant : params sort du chemin et participe à l'appariement de la route, query vient après le point d'interrogation et n'y participe pas. Et quand seul un params change, Vue Router réutilise le composant au lieu de le recréer.

Les termes à connaître

createRouter

La fonction qui construit l'instance de routeur à partir d'un mode d'historique et d'un tableau de routes. On l'installe ensuite avec app.use(router).

Segment dynamique

Une partie de chemin déclarée avec deux-points, comme /produits/:id. Sa valeur se retrouve dans route.params.

params

Les valeurs extraites des segments dynamiques du chemin. Elles font partie de l'identité de l'URL.

query

Les paramètres situés après le point d'interrogation. Ils ne participent pas à l'appariement de la route.

RouterLink

Le composant qui produit un lien de navigation interne. Il rend une balise a mais intercepte le clic au lieu de recharger la page.

useRoute

Le composable qui donne accès à la route courante, un objet réactif qu'on lit sans l'écrire.

useRouter

Le composable qui donne accès à l'instance de routeur, celle qui permet de naviguer par le code.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.