Навигация по маршрутам
В этой главе вы узнаете, как использовать React Router v6 для реализации навигации по страницам без перезагрузки, включая динамические маршруты и чтение параметров.
Зачем использовать маршрутизацию?
Традиционные многостраничные сайты запрашивают у сервера новую страницу при каждом нажатии ссылки, что вызывает мерцание белого экрана.
Фронтенд-маршрутизацияОна позволяет JavaScript управлять тем, какой компонент отображается при изменении URL, без отправки запросов на сервер.
Преимущества:Плавное переключение, ощущение как от нативного приложения。
Основные концепции React Router v6
| Концепция | Назначение | Соответствующий код |
|---|---|---|
| Таблица маршрутов | Определяет сопоставление между URL и компонентами | <Routes> + <Route> |
| Выход маршрута | Плейсхолдер, где отображаются дочерние маршруты | <Outlet /> |
| Навигационная ссылка | Нажмите для перехода | <Link to="..."> |
| Динамический маршрут | Переменная в URL | /post/:id |
| Чтение параметров | Получение значения из динамического маршрута | useParams() |
Установка и настройка
$ npm install react-router-dom@6
Создание конфигурации маршрутов
Пример
import { createBrowserRouter } from 'react-router-dom'
import App from '../App'
import HomePage from '../pages/HomePage'
import PostPage from '../pages/PostPage'
// createBrowserRouter создаёт экземпляр роутера
const router = createBrowserRouter([
{
path: '/', // App выступает в роли корневого макета
element: <App />,
children: [
{
index: true, // index: true означает дочерний маршрут по умолчанию для пути /
element: <HomePage />
},
{
path: 'post/:id', // Динамический маршрут: :id соответствует любому значению
element: <PostPage />
}
]
}
])
export default router
Два режима роутера:createBrowserRouterСоздаёт чистые URL (/post/1), требуя настройки сервера. Если среда развёртывания неизвестна, используйтеcreateHashRouter, URL содержит # (/#/post/1), и настройка сервера не требуется.
Зарегистрируйте Router в 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 внедряет роутер в приложение */}
<RouterProvider router={router} />
</React.StrictMode>
)
Используйте Outlet в 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 — это место вывода для вложенных маршрутов: здесь рендерится компонент, сопоставленный дочерними маршрутами */}
<Outlet />
</main>
<footer className="footer">
<p>© 2024 Пример блога. Работает на React.</p>
</footer>
</div>
)
}
export default App
Link — Декларативная навигация
LinkЗаменяет традиционный<a>тег и не вызывает перезагрузку страницы.
Пример
function BlogCard({ id, title, summary, date, category }) {
return (
<Link to={`/post/${id}`} className="card-link">
<div className="card">
<span className="tag">{category}</span>
<h3>{title}</h3>
<p>{summary}</p>
<span className="date">{date}</span>
</div>
</Ссылка>
)
}
Не используйте
<a href="....html">— это заставляет браузер запрашивать новую страницу с сервера, и всё React-приложение будет повторно инициализировано. Используйте<Link to="...">для переключения на стороне клиента без обновления.
useParams — чтение параметров маршрута
На странице детали нужно извлечь ID статьи из URL, чтобы найти соответствующую статью.
Пример
function PostPage() {
// useParams возвращает объект, содержащий параметры в URL
const { id } = useParams()
// Примечание: id — строка; если нужно число, используйте Number(id), чтобы преобразовать его
return (
<div>
<p>Текущий ID статьи:{id}</p>
</div>
)
}
useNavigate — программная навигация
В некоторых сценариях нужно перейти без клика по ссылке (например, после отправки формы или возврата на главную страницу, когда статья не найдена).
Пример
function PostPage() {
const navigate = useNavigate()
const article = null // Предположим, статья не найдена
if (!article) {
// Если статья не существует, перейти обратно на главную страницу
return (
<div>
<p>Статья не найдена</p>
<button onClick={() => navigate('/')}>Вернуться на главную</button>
</div>
)
}
return <div>Детали статьи...</div>
}
Сравнение Vue3 и React Router API
| Характеристика | Vue3 | React |
|---|---|---|
| Навигационная ссылка | <RouterLink> | <Link> |
| Выход маршрута | <RouterView> | <Outlet> |
| Динамический маршрут | /post/:id | /post/:id |
| Чтение параметров | useRoute().params | useParams() |
| Программная навигация | useRouter().push() | useNavigate() |
Практика: Полная страница деталей + интеграция с Router
Шаг 1: Измените BlogCard для поддержки навигации по клику
Пример
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">{category}</span>
<h3>{title}</h3>
<p>{summary}</p>
<span className="date">{date}</span>
</div>
</Ссылка>
)
}
export default BlogCard
Шаг 2: Создайте HomePage и PostPage
Пример
import { useState, useMemo } from 'react'
import BlogCard from '../components/BlogCard'
import CategoryFilter from '../components/CategoryFilter'
function HomePage() {
const [articles] = useState([
{ id: 1, title: 'Полное руководство по React для начинающих', summary: 'Изучение React с нуля', category: 'React', date: '2024-05-10',
content: '<h2>Почему стоит изучать React?</h2><p>React в настоящее время — один из самых популярных фронтенд-фреймворков...</p>' },
{ id: 2, title: 'Асинхронное программирование на JS: объяснение', summary: 'Понимание Promise и async/await', category: 'JavaScript', date: '2024-05-08',
content: '<h2>Что такое асинхронность?</h2><p>JS — однопоточный; асинхронные операции могут не блокировать основной поток...</p>' },
{ id: 3, title: 'Практика CSS Grid Layout', summary: 'Используйте Grid для создания адаптивных макетов', category: 'CSS', date: '2024-05-05',
content: '<h2>Начало работы с Grid</h2><p>Grid — это двумерная система макетов...</p>' },
])
const [activeCategory, setActiveCategory] = useState('Все')
const categories = useMemo(() => {
return ['Все', ...new Set(articles.map(a => a.category))]
}, [articles])
const filteredArticles = useMemo(() => {
if (activeCategory === 'All') return articles
return articles.filter(a => a.category === activeCategory)
}, [articles, activeCategory])
return (
<div>
<h2 className="section-title">Последние статьи</h2>
<CategoryFilter
categories={categories}
activeCategory={activeCategory}
onCategoryChange={setActiveCategory}
/>
<p className="result-info">Всего{filteredArticles.length}статей</p>
{filteredArticles.length === 0 ? (
<p className="empty-tip">В этой категории пока нет статей</p>
) : (
<div className="article-grid">
{filteredArticles.map(article => (
<BlogCard key={article.id} {...article} />
))}
</div>
)}
</div>
)
}
export default HomePage
Пример
import { useParams, Link } from 'react-router-dom'
import { useMemo } from 'react'
// Данные статьи (будут загружены из внешних источников в следующих главах)
const articles = [
{ id: 1, title: 'Полное руководство по React для начинающих', category: 'React', date: '2024-05-10',
content: '<h2>Почему стоит изучать React?</h2><p>React в настоящее время — один из самых популярных фронтенд-фреймворков...</p>' },
{ id: 2, title: 'Асинхронное программирование в JS: объяснение', category: 'JavaScript', date: '2024-05-08',
content: '<h2>Что такое асинхронность?</h2><p>JS однопоточный...</p>' },
]
function PostPage() {
const { id } = useParams()
// Найти статью по ID
const article = useMemo(() => {
return articles.find(a => a.id === Number(id))
}, [id])
// Статья не найдена
if (!article) {
return (
<div className="not-found">
<h2>Статья не найдена</h2>
<p>Статья с ID{id}не найдена.</p>
<Ссылка на="/">Вернуться на главную</Ссылка>
</div>
)
}
// Статья существует
return (
<article className="post-view">
<span className="category-tag">{article.category}</span>
<h1>{article.title}</h1>
<time>{article.date}</time>
{/* dangerouslySetInnerHTML эквивалентен v-html во Vue, остерегайтесь рисков XSS */}
<div
className="content"
dangerouslySetInnerHTML={{ __html: article.content }}
/>
<Link to="/" className="back-link">← На главную</Link>
</article>
)
}
export default PostPage
dangerouslySetInnerHTML— это React-версияv-html. Название намеренно длинное, чтобы напомнить вам: не используйте его для отображения пользовательского контента, существует риск безопасности XSS. Содержимое здесь написано самими разработчиками, поэтому оно безопасно.
Добавьте стили для PostPage
Пример
.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;
}
Краткое содержание главы
В этой главе вы изучили основы React Router v6: конфигурацию таблицы маршрутов (createBrowserRouter), навигацию с помощью Link, вложенный Outlet, динамический маршрут /post/:id, чтение параметров с помощью useParams и программную навигацию с помощью useNavigate.
Теперь блог имеет настоящий многостраничный интерфейс — просматривайте список на главной странице, нажмите, чтобы перейти на страницу подробностей и прочитать полное содержимое.
Другие расширения