Navigation entre les routes

Dans ce chapitre, vous apprendrez à utiliser React Router v6 pour implémenter une navigation entre les pages sans rafraîchissement, y compris les routes dynamiques et la lecture des paramètres.


Pourquoi utiliser le routage ?

Les sites web multipages traditionnels demandent une nouvelle page au serveur chaque fois que vous cliquez sur un lien, ce qui provoque un clignotement d'écran blanc.

Routage frontendIl permet à JavaScript de contrôler quel composant est affiché lorsque l'URL change, sans envoyer de requêtes au serveur.

Avantages :Transition fluide, l'expérience donne l'impression d'une application native。


Concepts clés de React Router v6

ConceptObjectifCode correspondant
Table des routesDéfinit la correspondance entre les URL et les composants<Routes> + <Route>
Point de sortie de routeEmplacement où les routes enfants sont affichées<Outlet />
Lien de navigationCliquer pour naviguer<Link to="...">
Route dynamiqueVariable dans l'URL/post/:id
Lire les paramètresRécupérer la valeur depuis la route dynamiqueuseParams()

Installation et configuration

$ npm install react-router-dom@6

Créer la configuration des routes

Exemple

// Chemin du fichier : src/router/index.jsx
import { createBrowserRouter } from 'react-router-dom'
import App from '../App'
import HomePage from '../pages/HomePage'
import PostPage from '../pages/PostPage'

// createBrowserRouter crée une instance de routeur
const router = createBrowserRouter([
  {
    path: '/',                // App agit comme le layout racine
    element: <App />,
    children: [
      {
        index: true,          // index: true signifie la route enfant par défaut pour le chemin /
        element: <HomePage />
      },
      {
        path: 'post/:id',     // Route dynamique : :id correspond à n'importe quelle valeur
        element: <PostPage />
      }
    ]
  }
])

export default router

Deux modes de routeur :createBrowserRouterProduit des URL propres (/post/1), nécessitant une configuration serveur. Si l'environnement de déploiement est incertain, utilisezcreateHashRouter, l'URL contient un # (/#/post/1), et aucune configuration serveur n'est nécessaire.

Enregistrer le routeur dans main.jsx

Exemple

// Chemin du fichier : src/main.jsx
import React from 'react'
import ReactDOM from 'react-dom/client'
import { RouterProvider } from 'react-router-dom'
import router from './router'
import './index.css'

ReactDOM.createRoot(document.getElementById('root')).render(
  <React.StrictMode>
    {/* RouterProvider injecte le routeur dans l'application */}
    <RouterProvider router={router} />
  </React.StrictMode>
)

Utiliser Outlet dans App.jsx

Exemple

// Chemin du fichier : src/App.jsx
import { Outlet } from 'react-router-dom'
import NavBar from './components/NavBar'
import './App.css'

function App() {
  return (
    <div className="app">
      <NavBar />
      <main className="container">
        {/* Outlet est le point de sortie pour les routes imbriquées : le composant correspondant aux routes enfants est rendu ici */}
        <Outlet />
      </main>
      <footer className="footer">
        <p>© 2024 EXEMPLE Blog. Propulsé par React.</p>
      </footer>
    </div>
  )
}

export default App

Link — Navigation déclarative

LinkRemplace la balise traditionnelle<a>et ne déclenche pas de rechargement de page.

Exemple

import { Link } from 'react-router-dom'

function BlogCard({ id, title, summary, date, category }) {
  return (
    <Link to={`/post/${id}`} className="card-link">
      <div className="card">
        <span className="tag">{catégorie}</span>
        <h3>{title}</h3>
        <p>{summary}</p>
        <span className="date">{date}</span>
      </div>
    </Lien>
  )
}

N'utilisez pas<a href="....html">— cela amène le navigateur à demander une nouvelle page au serveur, et toute l'application React sera réinitialisée. Utilisez<Link to="...">pour basculer côté client sans rafraîchissement.


useParams — Lecture des paramètres de route

Sur la page de détail, vous devez extraire l'ID de l'article à partir de l'URL pour trouver l'article correspondant.

Exemple

import { useParams } from 'react-router-dom'

function PostPage() {
  // useParams renvoie un objet contenant les paramètres de l'URL
  const { id } = useParams()
  // Remarque : id est une chaîne ; si vous avez besoin d'un nombre, utilisez Number(id) pour le convertir

  return (
    <div>
      <p>ID de l'article actuel :{id}</p>
    </div>
  )
}

useNavigate — Navigation programmatique

Dans certains scénarios, vous devez naviguer sans cliquer sur un lien (par exemple, après avoir soumis un formulaire, ou revenir à la page d'accueil lorsqu'un article est introuvable).

Exemple

import { useNavigate } from 'react-router-dom'

function PostPage() {
  const navigate = useNavigate()

  const article = null  // Supposons que l'article soit introuvable

  if (!article) {
    // Lorsque l’article n’existe pas, revenir à la page d’accueil
    return (
      <div>
        <p>Article introuvable</p>
        <button onClick={() => navigate('/')}>Retour à l’accueil</button>
      </div>
    )
  }

  return <div>Détails de l’article...</div>
}

Comparaison de l’API Vue3 vs React Router

FonctionnalitéVue3React
Lien de navigation<RouterLink><Link>
Point de sortie de route<RouterView><Outlet>
Route dynamique/post/:id/post/:id
Lire les paramètresuseRoute().paramsuseParams()
Navigation programmatiqueuseRouter().push()useNavigate()

Mise en pratique : page de détails complète + intégration du routeur

Étape 1 : Modifier BlogCard pour prendre en charge la navigation au clic

Exemple

// Chemin du fichier : src/components/BlogCard.jsx
import { Link } from 'react-router-dom'

function BlogCard({ id, title, summary, date, category }) {
  return (
    <Link to={`/post/${id}`} className="card-link">
      <div className="card">
        <span className="tag">{catégorie}</span>
        <h3>{title}</h3>
        <p>{summary}</p>
        <span className="date">{date}</span>
      </div>
    </Lien>
  )
}

export default BlogCard

Étape 2 : Créer HomePage et PostPage

Exemple

// Chemin du fichier : src/pages/HomePage.jsx
import { useState, useMemo } from 'react'
import BlogCard from '../components/BlogCard'
import CategoryFilter from '../components/CategoryFilter'

function HomePage() {
  const [articles] = useState([
    { id: 1, title: 'Le guide complet de React pour les débutants', summary: 'Apprendre React à partir de zéro', category: 'React', date: '2024-05-10',
      content: '<h2>Pourquoi apprendre React ?</h2><p>React est actuellement l’un des frameworks frontend les plus populaires...</p>' },
    { id: 2, title: 'Programmation asynchrone JS expliquée', summary: 'Comprendre Promise et async/await', category: 'JavaScript', date: '2024-05-08',
      content: '<h2>Qu’est-ce que l’asynchrone ?</h2><p>JS est mono-thread ; les opérations asynchrones peuvent garder le thread principal non bloqué...</p>' },
    { id: 3, title: 'Pratique de mise en page CSS Grid', summary: 'Utiliser Grid pour créer des mises en page responsives', category: 'CSS', date: '2024-05-05',
      content: '<h2>Débuter avec Grid</h2><p>Grid est un système de mise en page bidimensionnel...</p>' },
  ])

  const [activeCategory, setActiveCategory] = useState('Toutes')

  const categories = useMemo(() => {
    return ['Toutes', ...new Set(articles.map(a => a.category))]
  }, [articles])

  const filteredArticles = useMemo(() => {
    if (activeCategory === 'Tous') return articles
    return articles.filter(a => a.category === activeCategory)
  }, [articles, activeCategory])

  return (
    <div>
      <h2 className="section-title">Derniers articles</h2>
      <CategoryFilter
        categories={categories}
        activeCategory={activeCategory}
        onCategoryChange={setActiveCategory}
      />
      <p className="result-info">common{filteredArticles.length}article</p>
      {filteredArticles.length === 0 ? (
        <p className="empty-tip">Aucun article dans cette catégorie pour le moment</p>
      ) : (
        <div className="article-grid">
          {filteredArticles.map(article => (
            <BlogCard key={article.id} {...article} />
          ))}
        </div>
      )}
    </div>
  )
}

export default HomePage

Exemple

// Chemin du fichier : src/pages/PostPage.jsx
import { useParams, Link } from 'react-router-dom'
import { useMemo } from 'react'

// Données d'article (seront chargées depuis des sources externes dans les chapitres suivants)
const articles = [
  { id: 1, title: 'Le guide complet de React pour débutants', category: 'React', date: '2024-05-10',
    content: '<h2>Pourquoi apprendre React ?</h2><p>React est actuellement l’un des frameworks frontend les plus populaires...</p>' },
  { id: 2, title: 'Programmation asynchrone en JS expliquée', category: 'JavaScript', date: '2024-05-08',
    content: '<h2>Qu’est-ce que l’asynchrone ?</h2><p>JS est monothread...</p>' },
]

function PostPage() {
  const { id } = useParams()

  // Trouver l’article par ID
  const article = useMemo(() => {
    return articles.find(a => a.id === Number(id))
  }, [id])

  // Article introuvable
  if (!article) {
    return (
      <div className="not-found">
        <h2>Article introuvable</h2>
        <p>L’article avec l’ID{id}n’a pas été trouvé.</p>
        <Link to="/">Retour à l’accueil</Link>
      </div>
    )
  }

  // L’article existe
  return (
    <article className="post-view">
      <span className="category-tag">{article.category}</span>
      <h1>{article.title}</h1>
      <time>{article.date}</time>
      {/* dangerouslySetInnerHTML est équivalent au v-html de Vue, attention aux risques de XSS */}
      <div
        className="content"
        dangerouslySetInnerHTML={{ __html: article.content }}
      />
      <Link to="/" className="back-link">← Retour à l'accueil</Link>
    </article>
  )
}

export default PostPage

dangerouslySetInnerHTMLest la version React dev-html. Le nom est volontairement long pour vous rappeler : ne l'utilisez pas pour afficher du contenu généré par les utilisateurs, il y a un risque de sécurité XSS. Le contenu ici est écrit par les développeurs eux-mêmes, il est donc sûr.

Ajouter des styles pour PostPage

Exemple

/* Chemin de fichier : ajouter les styles de la page de détail à src/App.css */
.post-view {
  max-width: 720px;
  margin: 0 auto;
}

.category-tag {
  display: inline-block;
  padding: 4px 12px;
  background: #e3f2fd;
  color: #1976d2;
  border-radius: 12px;
  font-size: 13px;
  margin-bottom: 12px;
}

.post-view h1 {
  font-size: 32px;
  margin-bottom: 12px;
  line-height: 1.4;
}

.post-view time {
  display: block;
  color: #999;
  font-size: 14px;
  margin-bottom: 30px;
}

.content {
  line-height: 1.8;
  font-size: 16px;
  color: #333;
}

.content h2 {
  margin: 24px 0 12px;
  font-size: 22px;
}

.content p {
  margin-bottom: 12px;
}

.back-link {
  display: inline-block;
  margin-top: 40px;
  color: #1976d2;
  text-decoration: none;
}

.not-found {
  text-align: center;
  padding: 60px 0;
}

Résumé du chapitre

Dans ce chapitre, vous avez appris le cœur de React Router v6 : la configuration de la table de routes (createBrowserRouter), la navigation avec Link, l'Outlet imbriqué, la route dynamique /post/:id, useParams pour lire les paramètres, et useNavigate pour la navigation programmatique.

Maintenant, le blog a une véritable expérience multi-page — parcourez la liste sur la page d'accueil, cliquez pour entrer dans la page de détail afin de lire le contenu complet.

Autres extensions