Formations — 1 037 leçons en français

Accueil › Vue.js › Routes imbriquées

Routes imbriquées

Vue Routerintermediaire

Une interface réelle est faite de gabarits emboîtés : une barre latérale permanente, une zone de contenu qui change, parfois des onglets à l'intérieur. Les routes imbriquées expriment exactement cette structure.

const routes = [
  {
    path: '/equipes/:id',
    component: () => import('@/views/Equipe.vue'),
    children: [
      { path: '', name: 'equipe-resume', component: Resume },
      { path: 'membres', name: 'equipe-membres', component: Membres },
      { path: 'projets/:projetId', name: 'equipe-projet', component: Projet },
    ],
  },
]

Les chemins des filles sont relatifs : ils n'ont pas de barre oblique initiale, et Vue Router les concatène à celui du parent. membres devient donc /equipes/:id/membres.

Le composant parent doit déclarer où ses filles s'affichent.

<!-- Equipe.vue -->
<template>
  <h1>Équipe {{ $route.params.id }}</h1>
  <nav>
    <RouterLink :to="{ name: 'equipe-membres' }">Membres</RouterLink>
  </nav>
  <RouterView />
</template>

Cette RouterView imbriquée est la pièce qu'on oublie. Sans elle, l'URL est appariée, le parent est rendu, et l'enfant n'apparaît nulle part.

La fille de chemin vide est la route par défaut : elle répond quand l'URL s'arrête à /equipes/7. Et comme les chemins deviennent longs, on nomme les routes et on navigue par name, pas par chaîne de caractères.

Les termes à connaître

children

Le tableau de routes filles d'une route. Leurs composants sont rendus dans la RouterView du composant parent.

RouterView imbriquée

Une seconde RouterView placée dans le composant d'une route parente. Elle accueille le composant de la route fille.

Chemin relatif

Un path de route fille qui ne commence pas par une barre oblique. Il est concaténé au chemin du parent.

Route par défaut

La route fille dont le path est une chaîne vide. Elle est affichée quand l'URL s'arrête au chemin du parent.

Route nommée

Une route dotée d'un name, qu'on vise par ce nom plutôt que par son chemin littéral.

matched

Le tableau des enregistrements de route appariés, du parent le plus externe jusqu'à l'enfant final.

Vue nommée

Plusieurs RouterView au même niveau, distinguées par un attribut name, alimentées par l'option components.

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.