※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。

Reactエコシステムで最も歴史あるルーティングライブラリ React Router が、v7・v8の2世代にわたる大刷新を経てフルスタックフレームワークに進化しました。2024年11月のv7リリースでRemixと統合、2026年にリリースされたv8では react-router-dom が廃止(react-router に一本化)され、React Server Components対応・Cloudflare Vite Plugin統合など現代的な機能が揃いました。

2026年10月現在の最新版は v8.5.1 です。本記事では Framework Mode を中心に、ファイルベースルーティング・loader/action・レンダリング戦略の実装まで、コード付きで徹底解説します。React Router v6系から移行を検討している方にも役立てられる内容です。

広告・楽天アフィリエイト

プログラミング技術書

実践寄りの技術書・参考書を探す。

楽天ポイント還元

技術書を楽天で見る →

React Router v8とは|v7からv8への変化

React Routerは2014年に誕生したReact向けルーティングライブラリで、現在もGitHubスター数が最多クラスのReactエコシステム必須ライブラリです。v6まではSPA向けクライアントサイドルーティングに特化していましたが、v7でRemix(Metaが開発したフルスタックフレームワーク)と統合し、サーバーサイドレンダリング・データフェッチ・Server Actionsをサポートしました。

v8の主な変更点は以下の通りです(GitHub リリースノートより)。

  • react-router-dom の廃止:react-router パッケージに一本化され、インポート先が統一された
  • Cloudflare Vite Pluginの統合:@react-router/cloudflare でCloudflare Workers/Pagesへの直接デプロイが容易に
  • RSC対応(unstable):React Server Componentsを用いたフレームワークモードが実験的にサポート
  • API-only Mode(unstable):UIなしのAPIサーバーとして使用する新モード
  • プリレンダリング強化:SPA fallback付きの静的プリレンダリングが改善
バージョン リリース 主な特徴
v6 2021年 ネストルート・Outlet・useNavigate、SPA専用
v7 2024年11月 Remix統合・Framework Mode・loader/action・SSR対応
v8 2026年 react-router-dom廃止・RSC対応・Cloudflare Plugin・API Modeなど

3つの動作モードを理解する

公式ドキュメントによると、React Router v8には用途に応じた3つのモードが存在します。

1. Framework Mode(推奨)

フルスタック開発向けのモードで、Viteプラグイン(@react-router/dev)と組み合わせて使います。ファイルベースルーティング・サーバーサイドloader/action・SSR/SSG/SPA切り替えがすべて利用可能です。元々Remix v2として存在していた機能が統合されており、新規プロジェクトには このモードを選ぶことを推奨 します。

2. Data Mode

クライアントサイドのみで動作しますが、loader/action・ネストルートなどData APIsを使いたい場合に利用します。createBrowserRouterでルートを定義し、既存のReactアプリに段階的に組み込む際に便利です。

3. Declarative Mode

React Router v6互換の最もシンプルなモードです。<Routes>と<Route>コンポーネントでJSX形式でルートを宣言します。loader/actionは使えませんが、移行コストが最小のため既存コードを段階的に移行する際に使います。

Framework Modeのセットアップ

公式インストールガイドに従って新規プロジェクトを作成します。

npx create-react-router@latest my-app
cd my-app
npm install
npm run dev

生成されるプロジェクト構成は以下の通りです。

my-app/
├── app/
│   ├── root.tsx          # ルートレイアウト
│   ├── routes.ts         # ルート定義ファイル
│   └── routes/
│       ├── home.tsx      # / ルート
│       └── about.tsx     # /about ルート
├── react-router.config.ts
├── vite.config.ts
└── package.json

vite.config.ts では @react-router/dev/vite プラグインを追加します。

// vite.config.ts
import { reactRouter } from "@react-router/dev/vite";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [reactRouter()],
});

react-router.config.ts でSSR・プリレンダリング・Cloudflare対応などの設定を行います。

// react-router.config.ts
import type { Config } from "@react-router/dev/config";

export default {
  ssr: true,          // SSR有効(デフォルト)
  // ssr: false,      // SPA/静的ファイル出力にするなら false
} satisfies Config;

ファイルベースルーティング

Framework Modeのルーティングは app/routes.ts でルートと対応ファイルを明示的に定義します(Next.jsの暗黙的ファイルルーティングとは異なり、明示的です)。

// app/routes.ts
import { type RouteConfig, index, route, layout, prefix } from "@react-router/dev/routes";

export default [
  index("routes/home.tsx"),
  route("about", "routes/about.tsx"),
  route("blog/:slug", "routes/blog.slug.tsx"),
  layout("routes/dashboard/layout.tsx", [
    index("routes/dashboard/home.tsx"),
    route("settings", "routes/dashboard/settings.tsx"),
  ]),
  ...prefix("api", [
    route("users", "routes/api/users.tsx"),
  ]),
] satisfies RouteConfig;

ルートセグメントの種類は以下の通りです。

関数 URL例 説明
index("file.tsx") / インデックスルート
route("path", "file.tsx") /path 通常のルート
route(":id", "file.tsx") /123, /abc 動的パラメータ
layout("layout.tsx", [...]) (URLなし) 共通レイアウト
prefix("api", [...]) /api/... プレフィックスグループ

データローディング|loader関数

Framework Modeのloaderは、ルートコンポーネントがレンダリングされる前にサーバーサイドで実行されるデータフェッチ関数です。

// app/routes/blog.slug.tsx
import type { Route } from "./+types/blog.slug";

// サーバーサイドで実行されるloader
export async function loader({ params }: Route.LoaderArgs) {
  const post = await fetchPost(params.slug);
  if (!post) {
    throw new Response("Not Found", { status: 404 });
  }
  return { post };
}

// コンポーネントはloaderDataを受け取る
export default function BlogPost({ loaderData }: Route.ComponentProps) {
  const { post } = loaderData;
  return (
    <article>
      <h1>{post.title}</h1>
      <div dangerouslySetInnerHTML={{ __html: post.html }} />
    </article>
  );
}

loaderのポイントは以下の通りです。

  • SSRでは常にサーバーで実行:DBへの直接アクセスや秘匿APIキーを使ったリクエストが安全にできる
  • 型安全:Route.LoaderArgs / Route.ComponentProps によって、loaderDataの型がコンポーネントに自動で伝播する
  • 並列フェッチ:ネストしたルートのloaderは並列実行されるため、ウォーターフォールが発生しない
  • エラーハンドリング:throw new Response() でHTTPステータス付きエラーをスローできる

クライアントサイドのみのデータフェッチには clientLoader が使えます。

// サーバーでもクライアントでも実行するなら loader を使う
// クライアントのみなら clientLoader を使う
export async function clientLoader({ params }: Route.ClientLoaderArgs) {
  const data = await fetch(`/api/posts/${params.slug}`).then(r => r.json());
  return { data };
}

Server Actions|action関数

フォームの送信やデータ更新には action関数を使います。<Form>コンポーネントと組み合わせることで、JavaScriptがなくてもフォームが機能するプログレッシブエンハンスメントが実現します。

// app/routes/contact.tsx
import { Form, redirect } from "react-router";
import type { Route } from "./+types/contact";

// POSTリクエストを受け取るaction(サーバーサイド)
export async function action({ request }: Route.ActionArgs) {
  const formData = await request.formData();
  const name = formData.get("name") as string;
  const email = formData.get("email") as string;

  // バリデーション
  if (!name || !email) {
    return { errors: { name: "名前は必須です", email: "メールは必須です" } };
  }

  // DB保存など
  await saveContact({ name, email });

  // 保存後はリダイレクト
  return redirect("/contact/thanks");
}

export default function ContactPage({ actionData }: Route.ComponentProps) {
  return (
    <Form method="post">
      <input name="name" placeholder="名前" />
      {actionData?.errors?.name && <p>{actionData.errors.name}</p>}
      <input name="email" type="email" placeholder="メール" />
      {actionData?.errors?.email && <p>{actionData.errors.email}</p>}
      <button type="submit">送信</button>
    </Form>
  );
}

<Form method="post">はPOSTリクエストを発行し、フォームのsubmit前後でloaderが再実行されるため、画面が自動更新されます。

ネストレイアウト

React Routerのネストレイアウトは、共通UIをルート階層に沿って組み合わせる機能です。<Outlet />コンポーネントで子ルートのレンダリング位置を指定します。

// app/routes/dashboard/layout.tsx
import { Outlet, NavLink } from "react-router";

export default function DashboardLayout() {
  return (
    <div style={{ display: "flex" }}>
      <nav>
        <NavLink to="/dashboard">ホーム</NavLink>
        <NavLink to="/dashboard/settings">設定</NavLink>
      </nav>
      <main>
        <Outlet />  {/* 子ルートのコンポーネントがここにレンダリングされる */}
      </main>
    </div>
  );
}

レイアウトとその子ルートのloaderは並列実行されるため、ネストが深くなっても待ち時間が増えません。また NavLink は現在のURLに一致すると active クラスが自動付与されます。

広告・楽天アフィリエイト

メカニカルキーボード

打鍵感で選ぶ開発者向けキーボード。

楽天ポイント還元

キーボードを楽天で見る →

レンダリング戦略の切り替え

Framework Modeのレンダリング戦略は react-router.config.ts で制御します。

SSR(デフォルト)

// react-router.config.ts
export default {
  ssr: true,  // デフォルト。リクエストごとにサーバーでレンダリング
} satisfies Config;

SPA モード

export default {
  ssr: false,  // クライアントのみ。静的ファイルとして出力される
} satisfies Config;

SPA モードではすべてのloaderが clientLoader として動作し、ビルド時に静的HTMLが生成されます。CDNで配信するシンプルなSPAに適しています。

プリレンダリング(静的生成)

export default {
  ssr: true,
  async prerender() {
    // ビルド時にプリレンダリングするURLのリストを返す
    const slugs = await fetchAllPostSlugs();
    return ["/", "/about", ...slugs.map(s => `/blog/${s}`)];
  },
} satisfies Config;

プリレンダリングを指定したURLはビルド時にHTMLとして生成され、CDNからサーブできます。動的なURLはSSRにフォールバックするハイブリッド構成も可能です。

ナビゲーション|Link・Form・useNavigate

ナビゲーションには3つの方法があります。

Link コンポーネント

import { Link } from "react-router";

// 通常のリンク
<Link to="/about">About</Link>

// 状態を渡す
<Link to="/product/1" state={{ from: "home" }}>商品1</Link>

// 新しいタブで開く
<Link to="/docs" target="_blank" rel="noopener">ドキュメント</Link>

Form コンポーネント

import { Form } from "react-router";

// POSTメソッドでactionを呼び出す
<Form method="post" action="/contact">
  <input name="q" />
  <button type="submit">送信</button>
</Form>

// GETメソッドで検索クエリをURLに反映(loader再実行)
<Form method="get">
  <input name="q" placeholder="検索" />
  <button type="submit">検索</button>
</Form>

useNavigate フック

import { useNavigate } from "react-router";

function MyButton() {
  const navigate = useNavigate();
  return (
    <button onClick={() => navigate("/dashboard")}>
      ダッシュボードへ
    </button>
  );
}

ペンディングUI

ペンディングUIはナビゲーション中やフォーム送信中のローディング状態を表示する仕組みです。

import { useNavigation } from "react-router";

function SubmitButton() {
  const navigation = useNavigation();
  const isSubmitting = navigation.state === "submitting";

  return (
    <button type="submit" disabled={isSubmitting}>
      {isSubmitting ? "送信中..." : "送信"}
    </button>
  );
}

// ページ遷移のグローバルローディングインジケーター
function GlobalSpinner() {
  const navigation = useNavigation();
  return navigation.state === "loading" ? <div className="spinner" /> : null;
}

navigation.state は "idle"・"loading"・"submitting" の3値で、どの状態かを判定できます。

Declarative Mode(v6互換モード)

既存のReact Router v6プロジェクトをv8に移行する場合、まずDeclarative ModeでURL変更なしに動かすことができます。

import { BrowserRouter, Routes, Route } from "react-router";

function App() {
  return (
    <BrowserRouter>
      <Routes>
        <Route path="/" element={<Home />} />
        <Route path="/about" element={<About />} />
        <Route path="/blog/:slug" element={<BlogPost />} />
      </Routes>
    </BrowserRouter>
  );
}

v6との構文上の最大の違いは react-router-dom からのインポートが react-router に変わった点です。

// v6(旧)
import { BrowserRouter, Routes, Route, Link } from "react-router-dom";

// v8(新)
import { BrowserRouter, Routes, Route, Link } from "react-router";
// react-router-dom は v8 で廃止

Next.js・TanStack Routerとの比較

項目 React Router v8 Next.js 15 TanStack Router
ルーティング定義 routes.ts(明示的) app/ディレクトリ(ファイルベース) ファイルベース / コード
データフェッチ loader(サーバー/クライアント) Server Components + fetch loader(クライアント中心)
ミューテーション action(サーバー) Server Actions なし(別途TanStack Query等)
型安全 Route Types自動生成 手動 or 型推論 完全型安全(売り)
RSC対応 unstable(v8.3+) 安定(App Router) なし
デプロイ先 Cloudflare/Vercel/Node.js等 Vercel最適化(他も可) SPA向け(静的ホスト)
エコシステム 成熟・実績多数 最大シェア 成長中

React Routerの特徴はプログレッシブエンハンスメントへの強いこだわりです。公式ドキュメントにもある通り、<Form>とactionを使った実装はJavaScriptが読み込まれる前でも動作するため、低速ネットワーク環境でも堅牢に機能します。Next.jsと比べると Vercel への依存がなく、Cloudflare Workers・Fly.io・Node.jsサーバーなどより柔軟なデプロイ先を選べる点も特徴です。

型安全な開発

React Router v8では 型安全が大幅に強化されました。ビルド時(またはVite開発サーバー起動時)に app/routes/+types/ 以下に型定義ファイルが自動生成されます。

// 生成される型は Route.LoaderArgs, Route.ActionArgs, Route.ComponentProps など
import type { Route } from "./+types/blog.slug";

// loaderの戻り値の型がコンポーネントに自動で流れる
export async function loader({ params }: Route.LoaderArgs) {
  const post = await db.post.findUnique({ where: { slug: params.slug } });
  return { post };
}

export default function BlogPost({ loaderData }: Route.ComponentProps) {
  // loaderData.post は自動的に型付けされている
  return <h1>{loaderData.post?.title}</h1>;
}

また href ユーティリティを使うとリンク先のURLパスも型安全に生成できます。

import { href } from "react-router";

// ルートが存在しないURLをコンパイルエラーで検出
const url = href("/blog/:slug", { slug: "my-post" });  // "/blog/my-post"

まとめ|React Router v8を選ぶ場面

React Router v8のFramework Modeが特に向いている場面をまとめます。

  • Cloudflare Workers/PagesへのデプロイをしたいReactアプリ:@react-router/cloudflareで純正サポート
  • 既存のReact Router v6/v7プロジェクトをフルスタック化したい:段階的移行が可能
  • Next.jsに依存したくないが、SSR・loader/actionのDX は欲しい:まさにこのユースケース向け
  • プログレッシブエンハンスメントを重視するプロジェクト:JS無効でもフォームが動く設計
  • Remixユーザーのアップグレード先:Remix v2 相当の機能が標準搭載

一方、既にNext.js App Routerを使っており RSC 活用が前提のプロジェクトや、TanStack Routerのような完全型安全を最優先にするケースでは、それぞれのツールの方が適しています。React Router v8はReactエコシステムの中でも特に「柔軟なデプロイ先」と「プログレッシブエンハンスメント」を重視する開発者にとって強力な選択肢です。

参考リンク