Formations — 1 037 leçons en français

Accueil › Angular › Définir des routes

Définir des routes

Le routeurdebutant

Le routeur Angular associe une URL à un composant. On décrit cette association dans un tableau Routes, généralement dans app.routes.ts :

// app.routes.ts
import { Routes } from '@angular/router';
import { ListeProduits } from './produits/liste-produits';
import { FicheProduit } from './produits/fiche-produit';
import { PageIntrouvable } from './page-introuvable';

export const routes: Routes = [
  { path: '', redirectTo: '/produits', pathMatch: 'full' },
  { path: 'produits', component: ListeProduits, title: 'Nos produits' },
  { path: 'produits/velo-01', component: FicheProduit },
  { path: '**', component: PageIntrouvable },
];

Ce tableau est activé avec provideRouter(), dans app.config.ts :

import { ApplicationConfig } from '@angular/core';
import { provideRouter } from '@angular/router';
import { routes } from './app.routes';

export const appConfig: ApplicationConfig = {
  providers: [provideRouter(routes)],
};

Le composant racine place ensuite un <router-outlet> : c'est l'emplacement où le composant de la route active s'affiche.

<!-- app.html -->
<nav>
  <a routerLink="/produits" routerLinkActive="actif">Produits</a>
</nav>
<router-outlet />

routerLink remplace href pour naviguer sans recharger la page. routerLinkActive ajoute une classe CSS au lien de la route active. Le routeur teste les routes dans l'ordre du tableau : la route ** (wildcard), qui capte toute URL non reconnue, doit donc toujours être placée en dernier.

Les termes à connaître

Routes

Type Angular qui décrit un tableau d'objets route (path, component, children...). C'est ce tableau, généralement exporté depuis app.routes.ts, que l'on passe à provideRouter().

provideRouter()

Fonction (@angular/router) qui active le routeur en fournissant ses providers à l'application. S'utilise dans la liste providers de app.config.ts, avec le tableau de routes en premier argument.

<router-outlet>

Directive qui marque, dans un template, l'endroit où le routeur affiche le composant correspondant à la route active. Une application a au moins un <router-outlet> dans son composant racine.

routerLink

Directive qui remplace href pour naviguer entre les routes sans recharger la page. Accepte une chaîne (routerLink="/produits") ou un tableau de segments ([routerLink]="['/produits', produit.id]").

routerLinkActive

Directive qui ajoute une ou plusieurs classes CSS au lien quand sa route correspond à l'URL active. Utile pour mettre en évidence l'onglet de navigation courant.

redirectTo et pathMatch

redirectTo redirige une route vers une autre. pathMatch: 'full' précise que la redirection ne s'applique que si l'URL correspond entièrement au path (indispensable pour un path: '', sinon toutes les URL correspondent au préfixe vide).

Route « wildcard » (**)

Route dont le path vaut ** : elle correspond à n'importe quelle URL non reconnue par les routes précédentes. Placée en dernier dans le tableau, elle sert de page « 404 ».

inject(Router)

Récupère le service Router pour naviguer par code (en dehors d'un routerLink), par exemple après la soumission d'un formulaire : this.router.navigate(['/panier']).

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.