※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。
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エコシステムの中でも特に「柔軟なデプロイ先」と「プログレッシブエンハンスメント」を重視する開発者にとって強力な選択肢です。