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
| Concept | Objectif | Code correspondant |
|---|---|---|
| Table des routes | Définit la correspondance entre les URL et les composants | <Routes> + <Route> |
| Point de sortie de route | Emplacement où les routes enfants sont affichées | <Outlet /> |
| Lien de navigation | Cliquer pour naviguer | <Link to="..."> |
| Route dynamique | Variable dans l'URL | /post/:id |
| Lire les paramètres | Récupérer la valeur depuis la route dynamique | useParams() |
Installation et configuration
$ npm install react-router-dom@6
Créer la configuration des routes
Exemple
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
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
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
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
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
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é | Vue3 | React |
|---|---|---|
| Lien de navigation | <RouterLink> | <Link> |
| Point de sortie de route | <RouterView> | <Outlet> |
| Route dynamique | /post/:id | /post/:id |
| Lire les paramètres | useRoute().params | useParams() |
| Navigation programmatique | useRouter().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
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
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
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
.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