Навигация по маршрутам

В этой главе вы узнаете, как использовать React Router v6 для реализации навигации по страницам без перезагрузки, включая динамические маршруты и чтение параметров.


Зачем использовать маршрутизацию?

Традиционные многостраничные сайты запрашивают у сервера новую страницу при каждом нажатии ссылки, что вызывает мерцание белого экрана.

Фронтенд-маршрутизацияОна позволяет JavaScript управлять тем, какой компонент отображается при изменении URL, без отправки запросов на сервер.

Преимущества:Плавное переключение, ощущение как от нативного приложения。


Основные концепции React Router v6

КонцепцияНазначениеСоответствующий код
Таблица маршрутовОпределяет сопоставление между URL и компонентами<Routes> + <Route>
Выход маршрутаПлейсхолдер, где отображаются дочерние маршруты<Outlet />
Навигационная ссылкаНажмите для перехода<Link to="...">
Динамический маршрутПеременная в URL/post/:id
Чтение параметровПолучение значения из динамического маршрутаuseParams()

Установка и настройка

$ npm install react-router-dom@6

Создание конфигурации маршрутов

Пример

// Путь к файлу: 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 создаёт экземпляр роутера
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

Пример

// Путь к файлу: 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 внедряет роутер в приложение */}
    <RouterProvider router={router} />
  </React.StrictMode>
)

Используйте Outlet в App.jsx

Пример

// Путь к файлу: 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 — это место вывода для вложенных маршрутов: здесь рендерится компонент, сопоставленный дочерними маршрутами */}
        <Outlet />
      </main>
      <footer className="footer">
        <p>© 2024 Пример блога. Работает на React.</p>
      </footer>
    </div>
  )
}

export default App

Link — Декларативная навигация

LinkЗаменяет традиционный<a>тег и не вызывает перезагрузку страницы.

Пример

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>
    </Ссылка>
  )
}

Не используйте<a href="....html">— это заставляет браузер запрашивать новую страницу с сервера, и всё React-приложение будет повторно инициализировано. Используйте<Link to="...">для переключения на стороне клиента без обновления.


useParams — чтение параметров маршрута

На странице детали нужно извлечь ID статьи из URL, чтобы найти соответствующую статью.

Пример

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

function PostPage() {
  // useParams возвращает объект, содержащий параметры в URL
  const { id } = useParams()
  // Примечание: id — строка; если нужно число, используйте Number(id), чтобы преобразовать его

  return (
    <div>
      <p>Текущий ID статьи:{id}</p>
    </div>
  )
}

useNavigate — программная навигация

В некоторых сценариях нужно перейти без клика по ссылке (например, после отправки формы или возврата на главную страницу, когда статья не найдена).

Пример

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

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

ХарактеристикаVue3React
Навигационная ссылка<RouterLink><Link>
Выход маршрута<RouterView><Outlet>
Динамический маршрут/post/:id/post/:id
Чтение параметровuseRoute().paramsuseParams()
Программная навигацияuseRouter().push()useNavigate()

Практика: Полная страница деталей + интеграция с Router

Шаг 1: Измените BlogCard для поддержки навигации по клику

Пример

// Путь к файлу: 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">{category}</span>
        <h3>{title}</h3>
        <p>{summary}</p>
        <span className="date">{date}</span>
      </div>
    </Ссылка>
  )
}

export default BlogCard

Шаг 2: Создайте HomePage и PostPage

Пример

// Путь к файлу: 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: 'Полное руководство по 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

Пример

// Путь к файлу: src/pages/PostPage.jsx
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

Пример

/* Путь к файлу: добавить стили страницы подробностей в 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;
}

Краткое содержание главы

В этой главе вы изучили основы React Router v6: конфигурацию таблицы маршрутов (createBrowserRouter), навигацию с помощью Link, вложенный Outlet, динамический маршрут /post/:id, чтение параметров с помощью useParams и программную навигацию с помощью useNavigate.

Теперь блог имеет настоящий многостраничный интерфейс — просматривайте список на главной странице, нажмите, чтобы перейти на страницу подробностей и прочитать полное содержимое.

Другие расширения