ルーティング遷移

この章では、React Router v6 を使ってリフレッシュなしのページ遷移を実装する方法を学びます。動的ルーティングとパラメータの取得も含みます。


なぜルーティングを使うのか?

従来の多ページサイトでは、リンクをクリックするたびにサーバーへ新しいページをリクエストするため、白画面のちらつきが発生します。

フロントエンドルーティングURL が変化したときに JS がどのコンポーネントを表示するかを制御し、サーバーへのリクエストは行いません。

利点:切り替えがスムーズで、ネイティブアプリのような体験。


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

2つのルーティングモード:createBrowserRouterクリーンな URL(/post/1)を生成し、サーバー設定が必要です。デプロイ環境が不明な場合はcreateHashRouterを使用します。URL に # が付き(/#/post/1)、サーバー設定は不要です。

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>
)

App.jsx で Outlet を使用する

例

// ファイルパス: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 サンプル Blog. Powered by 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>
    </Link>
  )
}

使用しないでください<a href="....html">——これを使用するとブラウザがサーバーに新しいページをリクエストし、React アプリ全体が再初期化されます。代わりに<Link to="...">を使用すると、クライアント側でリフレッシュなしの切り替えができます。


useParams — ルーティングパラメータの取得

詳細ページでは、URL から記事 ID を取り出して、対応する記事を見つける必要があります。

例

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 vs React ルーティングAPI対照

機能Vue3React
ナビゲーションリンク<RouterLink><Link>
ルーティング出口<RouterView><Outlet>
動的ルーティング/post/:id/post/:id
パラメータの取得useRoute().paramsuseParams()
プログラマティック遷移useRouter().push()useNavigate()

実践:完全な詳細ページ + ルーティング統合

ステップ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>
    </Link>
  )
}

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 レイアウト実践', summary: 'Grid でレスポンシブレイアウトを実現', category: 'CSS', date: '2024-05-05',
      content: '<h2>Grid 入門</h2><p>Grid は2次元レイアウトシステムです...</p>' },
  ])

  const [activeCategory, setActiveCategory] = useState('すべて')

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

  const filteredArticles = useMemo(() => {
    if (activeCategory === 'すべて') 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>
        <Link to="/">ホームに戻る</Link>
      </div>
    )
  }

  // 記事が存在する
  return (
    <article className="post-view">
      <span className="category-tag">{article.category}</span>
      <h1>{article.title}</h1>
      <time>{article.date}</time>
      {/* dangerouslySetInnerHTML は Vue の v-html に相当する。XSS リスクに注意 */}
      <div
        className="content"
        dangerouslySetInnerHTML={{ __html: article.content }}
      />
      <Link to="/" className="back-link">← ホームに戻る</Link>
    </article>
  )
}

export default PostPage

dangerouslySetInnerHTMLは React 版のv-htmlv-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 によるプログラマティック遷移です。

これでブログに本当の多ページ体験が生まれました——ホームでリストを閲覧し、クリックすると詳細ページで完全なコンテンツを読めます。

その他の拡張