---
title: "React Router v8の使い方｜meta・title設定と基本ルーティング、v7からの変更点"
url: "https://www.issoh.co.jp/tech/details/7618/"
published: 2025-07-09
updated: 2026-10-18
categories: ["React"]
publisher: "株式会社一創"
---

# React Router v8の使い方｜meta・title設定と基本ルーティング、v7からの変更点

React Routerの最新版は、2026年9月15日公開の**8.4.0**です（v8.0.0は2026年6月17日）。v8では`react-router-dom`パッケージが削除され、基本APIは`react-router`、RouterProviderなどのDOM向けAPIは`react-router/dom`からimportします。本記事は、v8のコードでルーティングの基本を押さえたうえで、ページごとの**title・meta設定**を扱います。React 19の`<title>`直書きは親子のルートで二重になり、react-helmet-async 3.0もReact 19では重複を消しません。どちらもnode v26.5.0・react-router 8.4.0・React 19.2.7で実際に動かして確かめた結果です。

## まとめ：React Router v8とmeta・title設定の要点

- **最新版**：8.4.0（2026-09-15）。7系も7.18.4（同日）まで更新が続き、8.xと7.xがセキュリティ更新の対象。
- **v8の主な変更**：Node 22.22.0以上・React 19.2.7以上が必須。`react-router-dom`削除、ESM専用化、metaの`data`引数は`loaderData`へ。
- **インストール**：`npm install react-router`だけ。v8環境に`react-router-dom`を足すと7.18.4が警告なしで入り、Routerの外と判定されるエラーになる。
- **title・meta**：React 19の`<title>`は1ページ1本だけ描画する（葉のルートに置く）。重複を自動で解消したいならフレームワークモードの`meta`export、データモードは`handle`＋`useMatches`。
- **No routes matched location**：一致するRouteが無いときの開発時警告。子の`<Routes>`を持つ親pathの`/*`漏れと、`<Routes>`の分割が見落としやすい原因。

## React Router v8の最新版と変更点

### 8.0.0から8.4.0までのリリース履歴

v8のマイナー・パッチ版の公開間隔は一定ではありません。各版の内容は[公式CHANGELOG](https://github.com/remix-run/react-router/blob/main/packages/react-router/CHANGELOG.md)から主なものを抜き出しました。

| 版     | 公開日        | 主な変更                           |
| ----- | ---------- | ------------------------------ |
| 8.0.0 | 2026-06-17 | メジャー版。react-router-dom削除・ESM専用 |
| 8.0.1 | 2026-06-18 | v7の名残のAppLoadContext型を削除       |
| 8.1.0 | 2026-06-29 | 計測APIが一致したルートパターンを返す           |
| 8.2.0 | 2026-07-08 | href()のエンコードとparams抽出の修正       |
| 8.3.0 | 2026-07-22 | パス引数のエンコードをRFC 3986準拠に         |
| 8.3.1 | 2026-08-28 | actionのOrigin検証とURL検証を強化       |
| 8.4.0 | 2026-09-15 | 内部コンテキストを分割し再描画を削減             |

8.3.1にはactionリクエストのOrigin検証の強化が入っているため、v8を使うなら8.3.1以降に上げておくべきです。公開日はnpm registryの`time`フィールドで確認しました。

### v7からの破壊的変更

[公式ブログのv8リリース告知](https://remix.run/blog/react-router-v8)は、破壊的変更はどれもv7のうちに対応できると説明しています。[公式の移行ガイド](https://reactrouter.com/upgrading/v7)に載っている変更を、v7とv8で並べました。

| 項目                 | v7（7.18.4）                | v8                              |
| ------------------ | ------------------------- | ------------------------------- |
| 最低環境               | Node 20・React 18          | Node 22.22.0・React 19.2.7       |
| Vite（フレームワークモード）   | 5.1以上                     | 7以上                             |
| パッケージ              | react-router-domも使える      | react-routerとreact-router/domのみ |
| モジュール形式            | CommonJSも同梱               | ESM専用                           |
| metaの引数            | data（非推奨）                 | loaderData                      |
| ミドルウェア             | future.v8\_middlewareで有効化 | 常に有効                            |
| loaderのrequest.url | 正規化済み                     | 生のURL（正規化はurl引数）                |
| Cloudflare開発       | cloudflareDevProxy        | @cloudflare/vite-plugin         |

宣言的モード（`BrowserRouter`）だけの小さなSPAなら、実際の作業はNode・Reactの版上げとimport元の書き換えでほぼ終わります。影響が大きいのは、独自サーバーで`getLoadContext`を書いているフレームワークモードの構成です。v8では`context`が常に`RouterContextProvider`になり、素のオブジェクトを返す書き方は通りません。

### v7を使い続ける場合とアップグレード手順

公式の[セキュリティポリシー](https://github.com/remix-run/react-router/blob/main/SECURITY.md)では、8.xと7.xがセキュリティ更新の対象で、6.x以下は対象外です。v8の公開と同時にReact Router v6とRemix v2はサポート終了（EOL）になりました。React 18から上げられない事情があるならv7に留まるのは妥当な選択で、v6のまま残すのは避けるべきです。移行ガイドの推奨手順は次の順番です。

- v7の最新マイナー版へ上げる（`npm install react-router@7`）。
- Node 22.22以上・React 19.2.7以上・（フレームワークモードは）Vite 7へ先に上げる。
- `future.v8_*`フラグを1つずつ有効にし、非推奨警告を消す。1手順ごとにコミットして出荷する。
- `react-router-dom`をアンインストールし、import元を書き換えてから`npm install react-router@latest`を実行する。フレームワークモードでは、導入済みの@react-router/dev・@react-router/node・@react-router/serveなども対応するv8へ更新する。

公式ブログによると、今後は年1回のメジャー版リリースに移ります。移行の仕組み（future flagで先に新しい挙動へ切り替えておく）は変わらないので、flagは出たら早めに有効にしておくと次のメジャー版への移行が軽く済みます。

## インストールとモードの選び方

### react-routerの導入とreact-router-dom混在の回避

```
npm install react-router
```

v8で注意したいのは、npm上の`react-router-dom`が非推奨の表示も無く残っている点です（2026-10-18時点でlatestは7.18.4、deprecatedの指定なし）。v8のプロジェクトで古い記事の手順どおり`npm install react-router-dom`を実行すると、エラーも警告も出ずに7.18.4が入り、その中に7.18.4の`react-router`がもう1つ入ります。

この状態で`BrowserRouter`を`react-router-dom`から、`useNavigate`を`react-router`からimportすると、Routerの内側に置いたコンポーネントでも次のエラーで落ちました（jsdom上での実測）。

```
useNavigate() may be used only in the context of a <Router> component.
```

2つの版はそれぞれ別のContextを持つため、v7のRouterをv8のフックからは見つけられません。`npm ls react-router`で版が2つ表示されたら、`npm uninstall react-router-dom`でv7側を外し、importを`react-router`にそろえてください。

### 3つのモードの違いとtitle・metaの設定方法

React Routerには書き方の異なる3つのモードがあり、title・metaの出し方もモードで変わります。[公式のモード比較](https://reactrouter.com/start/modes)では、`<Meta>`コンポーネントはフレームワークモード専用、`useMatches`はデータモードとフレームワークモードで使えるとされています。

| モード     | 入口                      | title・metaの方法          |
| ------- | ----------------------- | ---------------------- |
| 宣言的     | BrowserRouter           | React 19の<title>直書き    |
| データ     | createBrowserRouter     | handle＋useMatches      |
| フレームワーク | npx create-react-router | meta exportか<title>直書き |

サーバーレンダリング（SSR）やプリレンダリングが要らないクライアント専用のSPAなら、宣言的モードで十分です。ルートごとのデータ取得（`loader`・`action`）を使う場合はデータモード以上が必要で、使い方は[React Routerのaction・loaderの使い方｜clientAction/clientLoaderの違いとv8対応](/tech/details/4436/)にまとめています。

## BrowserRouterによる基本ルーティングの定義

宣言的モードでは、エントリーポイントで`BrowserRouter`を1回だけ置き、`Routes`の中に`Route`を並べます。v8では`BrowserRouter`も`react-router`からimportします。

```
import ReactDOM from "react-dom/client";
import { BrowserRouter, Routes, Route } from "react-router";
import Home from "./pages/Home";
import About from "./pages/About";
import NotFound from "./pages/NotFound";

ReactDOM.createRoot(document.getElementById("root")).render(
  <BrowserRouter>
    <Routes>
      <Route index element={<Home />} />
      <Route path="about" element={<About />} />
      <Route path="*" element={<NotFound />} />
    </Routes>
  </BrowserRouter>
);
```

`index`は親パスそのもの（ここではトップ）に対応し、`path="*"`はどのルートにも一致しなかったときの受け皿です。パスの照合は既定で大文字小文字を区別せず、末尾のスラッシュも無視されます（`/About`と`/about/`はどちらも`path="about"`に一致しました）。大文字小文字を区別したいルートだけ`caseSensitive`を付けます。末尾スラッシュの有無は、この指定では区別されません。

### Link・NavLink・useNavigateによる画面遷移

`<a>`はページ全体を再読み込みするため、アプリ内の画面遷移には`<Link>`を使います。外部サイトへのリンクは`<a>`のままで構いません。現在地を強調するメニューは`<NavLink>`、フォーム送信後などコードから遷移するときは`useNavigate`を使います。

```
import { Link, NavLink, useNavigate } from "react-router";

function Nav() {
  const navigate = useNavigate();
  return (
    <nav>
      <Link to="/about">会社情報</Link>
      <NavLink to="/contact" className={({ isActive }) => (isActive ? "active" : "")}>
        お問い合わせ
      </NavLink>
      <button onClick={() => navigate(-1)}>戻る</button>
    </nav>
  );
}
```

`navigate(-1)`は履歴を1つ戻ります。ただし、戻れる履歴がない場合や外部サイトへ戻る場合があるため、戻り先を保証できない画面では一覧などの固定パスへのリンクを用意します。MUIのボタンやタブに`Link`を組み込む方法は[MUIのLinkとReact Routerで画面遷移を実装する方法｜component指定とテーマ一元化（v9／v8対応）](/tech/details/4299/)で扱っています。

### useParamsによるURLパラメータ（id）の取得

商品詳細のようにIDで内容を切り替えるルートは、パスに`:id`を書き、`useParams`で取り出します。

```
import { useParams } from "react-router";

// ルート定義：<Route path="products/:id" element={<ProductDetail />} />
function ProductDetail() {
  const { id } = useParams();
  return <p>商品ID: {id}</p>;
}
```

`useParams`で取得したパラメータは、値が存在すれば文字列です。省略可能なパラメータがURLにない場合などはundefinedになります（`/products/42`で`typeof id`は`"string"`でした）。数値で比較するなら`Number(id)`で変換します。パスに含めない検索条件は`?key=value`のクエリ文字列で扱い、型付きで読み書きするなら[nuqsとは？useQueryStateの使い方と2.10までの新機能・debounceの使いどころ](/tech/details/8535/)が候補になります。

### Outletによるネストルートと共通レイアウトの構成

ヘッダーを複数ページで共有するには、親ルートにレイアウトを置き、`<Outlet>`の位置に子ルートを描画させます。

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

function Layout() {
  return (
    <div>
      <Header />
      <main><Outlet /></main>
    </div>
  );
}

<Routes>
  <Route element={<Layout />}>
    <Route path="dashboard" element={<Dashboard />} />
    <Route path="settings" element={<Settings />} />
  </Route>
</Routes>
```

pathを持たない親ルートは、URLを増やさずにレイアウトだけを共有します。次の章のtitle重複は、このレイアウトにも`<title>`を書いたときに起きます。

## React Routerのページ別title・meta設定

SPAは初期HTMLの`<head>`が全ページ共通になるため、ルートごとにtitleとmeta descriptionを出し分ける必要があります。React 19からはライブラリなしで書けるようになりましたが、ネストルートと組み合わせたときの重複に注意が要ります。

### React 19のルートコンポーネント内でのtitle・meta指定

React 19では、コンポーネントのどこに`<title>`や`<meta>`を書いても、Reactが`<head>`へ移します。v8はReact 19.2.7以上が必須なので、v8を使っていればこの機能は必ず使えます。[React Routerの公式ドキュメント](https://reactrouter.com/start/framework/route-module)も、React 19以降は`meta`exportより組み込みの`<meta>`要素を推奨しています。

```
import { useParams } from "react-router";

function ProductDetail() {
  const { id } = useParams();
  return (
    <>
      <title>{`商品 ${id} | ストア名`}</title>
      <meta name="description" content={`商品 ${id} の詳細ページです`} />
      <h1>商品 {id}</h1>
    </>
  );
}
```

ページから離れて`ProductDetail`がアンマウントされると、`<head>`に移したtitleも消えます（実測でアンマウント後の`<title>`は0本）。

### 親子ルートのtitle重複とSSRでの出力順

レイアウト（親）に既定のtitleを書き、詳細ページ（子）でも書くと、`<head>`にtitleが2本残ります。[react.devの<title>リファレンス](https://react.dev/reference/react-dom/components/title)は、複数のコンポーネントが同時にtitleを描画したときのブラウザと検索エンジンの挙動を「未定義」としています。実際に動かすと、クライアント描画とSSRで順番が逆になりました。

| 描画方法                     | headのtitleの順  | document.title |
| ------------------------ | ------------- | -------------- |
| クライアント（createRoot・jsdom） | 商品 42 → 親タイトル | 商品 42          |
| SSR（renderToString）      | 親タイトル → 商品 42 | 親タイトル          |

HTMLでは文書内の最初の`<title>`がページのタイトルになるため、SSRの初期HTMLでは全ページが親の既定titleを名乗ることになります。`<meta name="description">`も親子で2本とも残りました。React 19の直書きでは、**titleとdescriptionは葉のルート（実際のページ）だけに書き、レイアウトには書かない**のが確実な回避策です。SSRとクライアント描画の違いは[CSRとSSRの違いと使い分け｜レンダリング方式を比較して実装で選ぶ](/tech/details/5895/)で整理しています。

### React 19でのreact-helmet-async 3.0の重複時の挙動

「重複するならreact-helmet-asyncを使う」という説明は、React 19とreact-helmet-async 3.0.0（2026-03-03公開）の組み合わせでは成り立ちません。[同ライブラリのREADME](https://github.com/staylor/react-helmet-async)によると、3.0.0は実行時にReactの版を判定し、React 19以上では`<Helmet>`が普通のDOM要素を描画して巻き上げをReactに任せ、`<HelmetProvider>`は何もしない素通しになります。

親と子の`<Helmet>`にそれぞれtitleを書いて動かすと、クライアントでもSSRでもtitleが2本出ました。React 18以前のhelmetにあった「後から描画したものが勝つ」という重複解消は、React 19では働きません。React 19で3.0.0を使う理由として残るのは、`titleTemplate`（実測で`%s | ストア`が展開された）と、`htmlAttributes`・`bodyAttributes`の設定です。titleを統一書式にしたいだけなら、文字列を組み立てる関数で足ります。

### フレームワークモードのmeta exportとloaderData参照

フレームワークモードでは、ルートモジュールから`meta`関数をexportし、rootの`<head>`に置いた`<Meta />`が描画します。公式の説明では、**最後に一致したルートのmeta配列だけが使われ、親の配列とはマージされずに丸ごと置き換わります**。各meta配列のtitleを1件にし、別の場所でtitleを描画しなければ、親子ルートのmeta exportによるtitleの重複を避けられます。

```
import type { Route } from "./+types/product";

export async function loader({ params }: Route.LoaderArgs) {
  return { name: `商品${params.id}` };
}

export function meta({ loaderData, matches, params }: Route.MetaArgs) {
  const root = matches.find((m) => m?.id === "root");
  return [
    { title: `${loaderData?.name} | ${root?.loaderData?.siteName ?? "ストア名"}` },
    { name: "description", content: `${loaderData?.name}の詳細ページです` },
    { property: "og:title", content: loaderData?.name },
    { tagName: "link", rel: "canonical", href: `https://example.com/products/${params.id}` },
  ];
}
```

v8で変わったのは引数名で、v7の`data`は削除され`loaderData`だけになりました（`matches`の各要素も同じ）。v7のコードを移すときは`data`を`loaderData`へ置換します。`{ "script:ld+json": {...} }`を返せばJSON-LDの`<script>`も出せます。親のmetaを引き継ぎたい場合は、`matches`から親の`meta`を取り出して自分で配列を組み立てます。

### データモードのhandle・useMatchesによるtitleの一元管理

`createBrowserRouter`のデータモードには`meta`exportがありません。代わりに各ルートの`handle`にtitleの作り方を持たせ、ルートのレイアウトで`useMatches`から最後の1件だけを描画すると、titleは常に1本になります。次はブラウザ用の構成例です。SSRの検証では、本文だけを描画する子コンポーネントとcreateMemoryRouterを使い、loaderの完了後にrenderToStringでtitleが1本になることを確認しました。

```
import { createBrowserRouter, Outlet, useMatches } from "react-router";
import { RouterProvider } from "react-router/dom";

function Root() {
  const matches = useMatches();
  const last = matches.findLast((m) => m.handle?.title);
  return (
    <>
      <title>{last ? last.handle.title(last) : "ストア名"}</title>
      <Outlet />
    </>
  );
}

function ProductDetail() {
  return <p>商品詳細</p>;
}

const router = createBrowserRouter([
  {
    path: "/",
    element: <Root />,
    children: [
      {
        path: "products/:id",
        element: <ProductDetail />,
        loader: ({ params }) => ({ name: `商品${params.id}` }),
        handle: { title: (m) => `${m.loaderData.name} | ストア名` },
      },
    ],
  },
]);

// 描画：<RouterProvider router={router} />
```

### SNS向けOGPの初期HTMLへの出力

ここまでの方法は、クライアント描画だけのSPAではJavaScript実行後に`<head>`へ入ります。SNSのリンクカードはサーバーが返したHTMLのOGPタグから作られるため、ルートごとのog:titleやog:imageを確実に出すには、フレームワークモードのSSRかプリレンダリングで初期HTMLに含めます。必須のOGPタグと画像サイズは[OGPタグの種類と書き方｜og:typeの値一覧とproductの扱い・画像サイズ・確認方法](/column/details/4899/)を参照してください。

### title・metaの設定方法を選ぶ基準

| 状況                    | 選ぶ方法                   |
| --------------------- | ---------------------- |
| 宣言的モードのSPA            | 葉のルートに<title>を直書き      |
| データモードで親にも既定値が要る      | handle＋useMatches      |
| SSR・loaderの値をtitleに使う | meta export            |
| html要素のlang等も変える      | react-helmet-async 3.0 |

titleのためだけに宣言的モードからフレームワークモードへ作り替えるのは過剰です。逆に、検索流入が事業上重要なページを持つなら、SSRを含むフレームワークモードを最初から選ぶ方が後の手戻りが少なくなります。ルーティングとSSRの方式を含めた設計から相談したい場合は、弊社の[フルスクラッチ開発](/service/system/fullscratch/)でも対応しています。

## 「No routes matched location」の原因と対処

### No routes matched locationの発生条件と検証結果

この文言は、現在のURLに一致する`Route`が1つも無いときに出る`console.warn`です。ソース上の書式は`No routes matched location "パス+クエリ+ハッシュ"`で、画面には何も描画されません。v8.4.0で次の4パターンを試しました。

- **受け皿の無い未定義パス**：`/nope`へ移動すると警告が出て、画面は空。`path="*"`を置けば警告は消える。
- **子の<Routes>を持つ親pathの`/*`漏れ**：`path="users"`の中で`<Routes>`を書くと、`/users/7`で警告が出て空になる。`path="users/*"`にすると表示された。
- **<Routes>を2つに分けた構成**：認証前後などで`<Routes>`を並べると、表示されている方とは別の`<Routes>`が一致なしで警告を出す。画面は正しく出るので、1つの`<Routes>`にまとめれば消える。
- **本番ビルド**：警告は開発ビルド（`development`条件）でだけ出る。本番ビルドでは同じ状況でも何も出ないので、空白画面の原因を本番のコンソールで探しても見つからない。

「No routes matched location “/”」と表示される場合は、トップに対応する`index`ルートか`path="/"`が抜けています。

### データモードの404とerrorElementによる処理

`createBrowserRouter`では、一致するルートが無いと警告ではなく404のエラーがルートの`errorElement`（または`ErrorBoundary`）に渡ります。実測では`isRouteErrorResponse(error)`が真になり、`status`は404、`data`は`Error: No route matches URL "/nope"`でした。`errorElement`が無いと既定の「Unexpected Application Error! 404 Not Found」画面になります。

```
import { useRouteError, isRouteErrorResponse } from "react-router";

function RootError() {
  const error = useRouteError();
  if (isRouteErrorResponse(error) && error.status === 404) {
    return <p>ページが見つかりません</p>;
  }
  return <p>エラーが発生しました</p>;
}

// createBrowserRouter([{ path: "/", element: <Root />, errorElement: <RootError />, children: [...] }])
```

存在しないIDの詳細ページも同じ画面に寄せたいときは、`loader`の中で`throw data("Not Found", { status: 404 })`を投げると、同じ`errorElement`で受けられます。

## よくある質問

### React Routerでページのtitleやmetaを設定するには？

v8（React 19必須）なら、ページのコンポーネントに`<title>`と`<meta>`を直接書けば`<head>`へ移ります。ただしレイアウトにも書くと二重になるため、葉のルートだけに書きます。フレームワークモードなら最後に一致したルートだけが使われる`meta`exportが確実です。

### React Router v8はいつリリースされ、最新版はいくつですか？

v8.0.0は2026年6月17日に公開され、2026年10月18日時点の最新版は8.4.0（2026年9月15日）です。公式は今後、年1回のメジャー版リリースに移ると告知しています。

### react-router-domはv8で使えますか？

使えません。v8で削除され、`RouterProvider`などDOM固有のAPIは`react-router/dom`、それ以外は`react-router`からimportします。npmの`react-router-dom`はv7系（7.18.4）のまま残っているので、v8の環境に入れると版が混在します。

### react-helmet-asyncはまだ必要ですか？

titleとmetaを出すだけなら不要です。3.0.0はReact 19では重複を消さずにReactの巻き上げに任せるため、helmetを入れても二重titleは直りません。`htmlAttributes`や`titleTemplate`を使いたい場合に限って残す価値があります。

### React Router v7のままで問題ありませんか？

セキュリティ更新は7.xも対象なので、すぐ困ることはありません。v8はReact 19.2.7とNode 22.22以上が必須のため、React 18から上げられない間はv7の最新パッチを当て続け、上げられた段階でv8へ移るのが現実的です。

## 関連記事

- [React Routerのaction・loaderの使い方｜clientAction/clientLoaderの違いとv8対応](/tech/details/4436/)
- [MUIのLinkとReact Routerで画面遷移を実装する方法｜component指定とテーマ一元化（v9／v8対応）](/tech/details/4299/)
- [TanStack Routerとは？型安全ルーティングの特徴・導入手順とReact Routerとの違い](/tech/details/9913/)
- [nuqsとは？useQueryStateの使い方と2.10までの新機能・debounceの使いどころ](/tech/details/8535/)
- [CSRとSSRの違いと使い分け｜レンダリング方式を比較して実装で選ぶ](/tech/details/5895/)

---

出典: [React Router v8の使い方｜meta・title設定と基本ルーティング、v7からの変更点](<https://www.issoh.co.jp/tech/details/7618/>)（株式会社一創）
