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 dansroute.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
amais 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.
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.