29 人が閲覧(直近 30 日) React

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

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本だけ描画する(葉のルートに置く)。重複を自動で解消したいならフレームワークモードのmetaexport、データモードはhandle+useMatches。
  • No routes matched location:一致するRouteが無いときの開発時警告。子の<Routes>を持つ親pathの/*漏れと、<Routes>の分割が見落としやすい原因。

React Router v8の最新版と変更点

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

v8のマイナー・パッチ版の公開間隔は一定ではありません。各版の内容は公式CHANGELOGから主なものを抜き出しました。

版 公開日 主な変更
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リリース告知は、破壊的変更はどれも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を使い続ける場合とアップグレード手順

公式のセキュリティポリシーでは、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の出し方もモードで変わります。公式のモード比較では、<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対応にまとめています。

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対応)で扱っています。

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の使いどころが候補になります。

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の公式ドキュメントも、React 19以降はmetaexportより組み込みの<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>リファレンスは、複数のコンポーネントが同時に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の違いと使い分け|レンダリング方式を比較して実装で選ぶで整理しています。

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

「重複するならreact-helmet-asyncを使う」という説明は、React 19とreact-helmet-async 3.0.0(2026-03-03公開)の組み合わせでは成り立ちません。同ライブラリのREADMEによると、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のデータモードにはmetaexportがありません。代わりに各ルートの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の扱い・画像サイズ・確認方法を参照してください。

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

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

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

「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>へ移ります。ただしレイアウトにも書くと二重になるため、葉のルートだけに書きます。フレームワークモードなら最後に一致したルートだけが使われるmetaexportが確実です。

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へ移るのが現実的です。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.18 テックブログ Java脆弱性CVE-2026-114938(Java4Shell)とは?影響版・修正版と回避フラグの実装手順
  2. 2026.11.11 テックブログ Vite 脆弱性 GHSA-p4f5-76q4-ffq7:開発サーバーRCEの確認と修正版への更新
  3. 2026.11.18 テックブログ 楽天証券の不正アクセス:最大約447万口座の対象確認と、テスト環境に本番データを置かない実装
  4. 2026.11.17 テックブログ チャットプラスの不正アクセス:導入企業がチャット履歴の個人データと報告準備を確かめる手順
  5. 2026.11.19 テックブログ 大崎電気のランサムウェア被害|スマートメーター生産停止の経緯と工場の生産系を守る手順

RELATED POSTS 関連記事

目次