/tasks/3 を直接開くと404になるのは、そのURLの担当が決まっていないからです。React Routerを入れて、リロードしても正しい画面が出る状態にします。
前回: 状態管理はライブラリの話ではない — Contextまで 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。前回の
~/react-demo/の続きです。
前回の最後に、こういう表を出しました。
| 種類 | 例 | 持ち主 | 使う道具 |
|---|---|---|---|
| URL の状態 | 検索語、ページ番号、絞り込み条件 | URL | ルーター(次の段階以降で扱います) |
その「ルーター」を、今日やります。
ですが、その前に確認したいことがあります。いま作っているタスクリストは、画面が1枚しかありません。 URL はずっと http://192.168.226.50:5173/ のままです。
画面が1枚しかないなら、ルーティングは要らないのでは? — これは正しい疑問です。そして、答えは「要らない」ではありません。
いまのアプリには、すでに3つの穴が開いています。
- ブラウザの「戻る」ボタンが、何もしません。 押すと、アプリごと前のサイトへ出ていきます
- 「この画面を見て」と人に送れません。 URL を送っても、相手には最初の画面が出ます
- リロードすると、見ていた場所に戻れません
そして、この記事の山場は、そこではありません。
ルーティングを入れて画面を3枚にし、ビルドして配ると、
/tasks/3に直接アクセスした瞬間に 404 が出ます。
この罠は、ビルドツールの回で予告してあります。 あのときは「そういう罠がある、とだけ覚えておいてください」と書きました。今日、実際に起こして、直します。
対象レベル: 初級 / 区分: 必修
この記事でわかること
- 画面のURL(
/tasks/3)と、APIのURL(/api/tasks/3)は、まったく別物だということ。似ているのは見た目だけで、返ってくるものも、作る人も違う <a href>と<Link>は「見た目が同じで、中身が正反対」であること。<a href>を1つ混ぜると、そこだけページ全体が再読み込みされ、React が持っていた状態が全部消える- SPA の
/tasks/3は、サーバーから見れば「存在しないファイル」だということ。404 はサーバーのバグではなく、正しい返事である - 「見つかりません画面」と「404」は別物であること。React が出す「見つかりません」は、HTTP としては 200(成功)で返っている
npm run previewで確認しても、この罠は見つからないこと。preview はフォールバックを内蔵しているので、本番と違う挙動になる- URL は状態のひとつだということ。絞り込み条件を
useStateに入れた瞬間、その画面は人に送れなくなる
この記事でやること
react-router-domを入れ、いまの1画面を一覧 / 詳細 / 見つかりませんの3画面に分ける- パスパラメータ
/tasks/:idをuseParamsで受け取り、文字列で届くことを確かめる <Link>を一時的に<a href>に書き換え、状態が消えるところを自分の目で見る- 絞り込みを
useSearchParamsで URL に持たせ、戻るボタンで絞り込みが戻ることを確かめる npm run buildして静的に配り、/tasks/3で 404 を出す。 そのうえで、サーバー側のフォールバックで直す
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| ルーティング | URL を見て、どの画面を出すかを決めること |
| ルーター | そのルーティングをやってくれる道具。ここでは react-router-dom |
| SPA(Single Page Application) | HTMLファイルは1枚だけで、画面の切り替えを JavaScript がやるアプリ |
| クライアントサイドルーティング | 画面の切り替えを、サーバーに聞かずにブラウザの中だけで済ませること |
| パスパラメータ | URL の一部を変数として扱う場所。 /tasks/:id の :id |
| クエリ文字列 | URL の ? から後ろ。 ?filter=done のような「おまけの条件」 |
| History API | ブラウザが持っている「URL を、ページを読み込まずに書き換える」機能 |
| フォールバック | 「見つからなかったときは、代わりにこれを返す」というサーバー側の設定 |
| 404 | HTTP の返事のひとつ。「そんなものは無い」という意味 |
① 準備 — 前回の続きから
VMの中で、前回のディレクトリに入ります。
/home/user/react-demo/src:
App.css App.jsx assets components contexts index.css main.jsx tasksReducer.js
/home/user/react-demo/src/components:
Board.jsx Header.jsx TaskForm.jsx TaskItem.jsx TaskList.jsx TaskMeta.jsx TaskSummary.jsx
/home/user/react-demo/src/contexts:
UserContext.js
この形になっていれば、前回の続きです。 違うときは前回からやり直してください。
前回の後片づけで 5173番を閉じました。 開け直します。今日は 8000番も使うので、まとめて開けます。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
8000/tcp ALLOW Anywhere
2行とも出ていることを確認してください。 開けずに進むと、起動は成功するのにブラウザは読み込み中のままになります。
起動します。
ホストの Windows のブラウザで http://192.168.226.50:5173/(IPは自分の値に。分からなければ VM の中で ip a)を開き、前回のタスクリストが動いていることを確認してから先へ進んでください。
この記事の間は、起動したままで構いません。 止めるときはターミナルで Ctrl+C です。
② いま、何が困っているのか
「タスクをクリックすると、そのタスクの詳細画面が出る」を作りたくなったとします。ごく普通の要求です。
ルーターを知らないと、こう書きます。
// ❌ 打ち込まなくて構いません。「こう書きたくなる」という例です
function App() {
const [tasks, dispatch] = useReducer(tasksReducer, initialTasks);
const [selectedId, setSelectedId] = useState(null); // ← いま何を見ているか
if (selectedId !== null) {
return <TaskDetail id={selectedId} onBack={() => setSelectedId(null)} />;
}
return <TaskListPage onSelect={setSelectedId} />;
}
これは動きます。 クリックすれば詳細が出て、「戻る」ボタンを自分で置けば一覧に戻れます。
そして、これで済ませてしまうと、次の3つが起きます。
困りごと1:ブラウザの「戻る」が、アプリごと出ていく
詳細画面を開いて、ブラウザの左上の「←」を押してください。
一覧に戻りません。 このサイトを開く前に見ていたページに戻ります。
理由は単純です。 URL が1ミリも変わっていないからです。 ブラウザにとって、「一覧」と「詳細」は同じ1ページです。戻る先が無いので、その前のサイトに戻ります。
これは、スマートフォンだと致命的です。多くの人が「戻る」で操作します。
困りごと2:いま見ている画面を、人に送れない
「このタスク、見といて」と URL を送ったとします。
相手のブラウザに出るのは、一覧の最初の画面です。selectedId は自分のブラウザのメモリの中にしかなく、URL には1文字も出ていないからです。
同じ理由で、こういうこともできません。
- ブックマークに入れる
- タブを複製して、2つの詳細を並べて見る
- リロードして、同じ場所に戻る
困りごと3:どの画面を出しているかが、コードから読み取れない
selectedId !== null という条件で分岐しています。 画面が3枚、4枚と増えると、こうなります。
// ❌ 画面が増えるとこうなる
if (selectedId !== null) return <TaskDetail ... />;
if (showSettings) return <Settings ... />;
if (showHelp) return <Help ... />;
return <TaskListPage ... />;
「いまどの画面か」を表す状態が、3つに分かれました。 2つ同時に true になったらどうなるかは、上から順に読まないと分かりません。
3つとも、原因は1つ
「いまどの画面を見ているか」を、URL ではなく
useStateに持ったこと。
前回の表を、もう一度出します。
| 種類 | 持ち主 |
|---|---|
| URL の状態(いま見ている画面、絞り込み、ページ番号) | URL |
「いま見ている画面」は、URL が持つべき状態です。そして URL が持てば、戻るボタンも、共有も、ブックマークも、ブラウザが最初から持っている機能として、ただで付いてきます。
ルーターがやっているのは、これだけです。
URL を状態として扱い、その値に応じて、出すコンポーネントを切り替える。
③ react-router-dom を入れる
Ctrl+C で開発サーバーを一度止めて、VMの中で入れます。
入ったことを確かめます。
react-demo@0.0.0 /home/user/react-demo
└── react-router-dom@7.1.1
バージョンの数字は違って構いません。 この記事の書き方は v6 でも v7 でも動きます。
[スクリーンショット: 01_react-router導入.png] npm install react-router-dom の実行後、npm ls react-router-dom の結果まで写るように撮ってください。バージョン番号が読める形で。
react-routerとreact-router-domの2つが出てきますが、入れるのは-domのほうです。react-routerが本体、react-router-domが「ブラウザ用の皮」です。-domを入れると本体も一緒に入ります。スマホアプリ(React Native)では別の皮を使うので、こう分かれています。
戻し方: npm uninstall react-router-dom で消えます。npmの回でやったとおり、node_modules/ は消してもやり直せます。
先に、id を作り直す
ルーティングを入れると、id が URL に出ます。 /tasks/1756891234567 です。
これは困ります。 前回、こう書きました。
本来 id は「見分けるためのもの」で、意味を持たせるべきではありません。
Date.now() を id にしたのは、その場しのぎでした。 URL に出るようになった以上、短くて、覚えられて、リロードしても同じ値のほうがいいです。
あわせて、最初から3件入った状態にします。 理由は、この記事の後半で「/tasks/3 に直接アクセスする」からです。毎回自分で3件打ち込むのは、確かめるときに面倒です。
src/tasksReducer.js を丸ごと置き換えます。
export const initialTasks = [
{ id: 1, title: "牛乳を買う", done: false },
{ id: 2, title: "ルーティングを試す", done: false },
{ id: 3, title: "ゴミを出す", done: true },
];
function nextId(tasks) {
return tasks.reduce((max, t) => Math.max(max, t.id), 0) + 1;
}
export function tasksReducer(tasks, action) {
switch (action.type) {
case "added":
return [...tasks, { id: nextId(tasks), title: action.title, done: false }];
case "toggled":
return tasks.map((t) =>
t.id === action.id ? { ...t, done: !t.done } : t
);
case "removed":
return tasks.filter((t) => t.id !== action.id);
case "completedAll":
return tasks.map((t) => ({ ...t, done: true }));
case "clearedDone":
return tasks.filter((t) => !t.done);
default:
throw new Error("知らない action.type です: " + action.type);
}
}
nextId の中身に注目してください。
tasks.reduce((max, t) => Math.max(max, t.id), 0) + 1
「いまある id の最大値 + 1」です。カウンター用の変数をファイルの外側に置いて nextId++ とはしていません。
なぜか。 reducer は「同じ入力なら、いつでも同じ結果を返す関数」でなければいけないからです。 外の変数を書き換えると、その約束が壊れます。 そして前回出てきた
<StrictMode>は、開発中に reducer をわざと2回呼びます。nextId++だと、呼ばれるたびに数字が飛びます。 必要な材料(tasks)から毎回計算するなら、何回呼ばれても結果は同じです。前回の「計算で出せるものを状態にしない」と、同じ話です。
この id の作り方は、本番では使いません。 2人が同時に追加したら、同じ id ができます。 本番では、サーバー側のデータベースが採番します。 ここでは「URL に出しても読める id」であれば十分です。
src/components/TaskMeta.jsx(丸ごと置き換え)
task.id から時刻を作っていた行が、意味を失いました(id が 1 では 1970年になります)。消します。
import { memo, useContext } from "react";
import { UserContext } from "../contexts/UserContext.js";
function TaskMeta({ task }) {
const { user } = useContext(UserContext);
return (
<span className="meta">
担当: {user} / id: {task.id}
</span>
);
}
export default memo(TaskMeta);
id を表示に出したのは、この後 URL と見比べるためです。
src/main.jsx(丸ごと置き換え)
ここが、ルーターの入口です。
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import { BrowserRouter } from 'react-router-dom'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(
<StrictMode>
<BrowserRouter>
<App />
</BrowserRouter>
</StrictMode>,
)
<BrowserRouter> で <App /> を囲みました。 前回の <UserContext.Provider> と、まったく同じ形です。
やっていることも、実は同じです。
<BrowserRouter>は「いまの URL」を Context で配っているだけです。この内側にいるコンポーネントだけが、useParamsや<Link>を使えます。 前回「Provider の外で読むと黙って既定値になる」と書きました。 ルーターの場合はもっと分かりやすく、useNavigate() may be used only in the context of a <Router> componentとエラーが出ます。
BrowserRouter の「Browser」は、「ブラウザの History API を使う」という意味です。あとで出てくる HashRouter との対比なので、覚えておいてください。
④ 画面を3枚に分ける
ここから、ファイルを4つ作ります。
| ファイル | 役割 |
|---|---|
src/pages/TaskListPage.jsx(新規) | 一覧の画面(/) |
src/pages/TaskDetailPage.jsx(新規) | 1件の詳細(/tasks/:id) |
src/pages/NotFoundPage.jsx(新規) | 知らないURLだったとき |
src/App.jsx(書き換え) | URL と画面の対応表を書く場所 |
src/components/TaskItem.jsx(書き換え) | 詳細へのリンクを足す |
src/index.css(書き換え) | 見た目 |
pages/という名前に、React 側の決まりはありません。components/と分けたのは、「画面まるごと」と「画面の部品」を見た目で区別できるようにするためです。多くのプロジェクトがこう分けています。
ディレクトリを作ります。
src/pages/TaskListPage.jsx(新規)
import Board from "../components/Board.jsx";
import TaskForm from "../components/TaskForm.jsx";
import TaskSummary from "../components/TaskSummary.jsx";
import TaskList from "../components/TaskList.jsx";
function TaskListPage({ tasks, dispatch }) {
return (
<Board>
<TaskForm onAdd={(title) => dispatch({ type: "added", title })} />
<TaskSummary tasks={tasks} />
<TaskList
tasks={tasks}
onToggle={(id) => dispatch({ type: "toggled", id })}
onRemove={(id) => dispatch({ type: "removed", id })}
/>
<div className="bulk">
<button onClick={() => dispatch({ type: "completedAll" })}>
全部完了にする
</button>
<button onClick={() => dispatch({ type: "clearedDone" })}>
完了したものを消す
</button>
</div>
</Board>
);
}
export default TaskListPage;
中身は、前回の App の return から切り出しただけです。新しいものは1つもありません。
src/pages/TaskDetailPage.jsx(新規)
この記事の主役です。
import { Link, useParams } from "react-router-dom";
import TaskMeta from "../components/TaskMeta.jsx";
function TaskDetailPage({ tasks, dispatch }) {
const { id } = useParams();
const task = tasks.find((t) => String(t.id) === id);
if (!task) {
return (
<div className="board">
<h2>そのタスクはありません</h2>
<p className="empty">URL に書かれた id: {id}</p>
<p>
<Link to="/">← 一覧に戻る</Link>
</p>
</div>
);
}
return (
<div className="board">
<h2 className={task.done ? "done" : ""}>{task.title}</h2>
<p>状態: {task.done ? "完了" : "未完了"}</p>
<TaskMeta task={task} />
<p>
<button onClick={() => dispatch({ type: "toggled", id: task.id })}>
{task.done ? "未完了に戻す" : "完了にする"}
</button>
</p>
<p>
<Link to="/">← 一覧に戻る</Link>
</p>
</div>
);
}
export default TaskDetailPage;
説明することが3つあります。
1つめ。useParams() が返すのはオブジェクトです。
const { id } = useParams();
/tasks/3 を開いていたら、{ id: "3" } が返ります。 id という名前は、次の節で path="/tasks/:id" と書いたときの :id から来ています。 :名前 と書いた場所が、そのまま useParams() のキーになります。
2つめ。ここが一番よく事故ります。
const task = tasks.find((t) => String(t.id) === id);
useParams()が返す値は、必ず文字列です。 URL は文字の列なので、3と"3"を区別する方法がありません。数字に見えても、届くのは"3"です。
だから、こう書くと永久に見つかりません。
const task = tasks.find((t) => t.id === id); // ❌ 1 === "3" ではなく、1 === "1" でも false
t.id は数値の 1、id は文字列の "1"。=== は false を返します。 JavaScriptの回でやった「"1" と 1 は等しいのか」が、ここで牙をむきます。
直し方は2つです。どちらでも構いません。
| 書き方 | やっていること |
|---|---|
String(t.id) === id | 数値を文字列にしてから比べる(この記事はこちら) |
t.id === Number(id) | 文字列を数値にしてから比べる |
==(イコール2つ)で比べる、はやめてください。 一見うまくいきますが、前に見たとおり、== は他の場面で嘘をつきます。
3つめ。「見つからなかったとき」を必ず書くこと。
/tasks/999 は、誰でも打ち込めます。 書かないと task が undefined になり、次の行の task.title で Cannot read properties of undefined が出て、画面が真っ白になります。
URL は、ユーザーが自由に書き換えられる入力欄です。
<input>に何を入れられるか分からないのと、まったく同じです。「そんな id は無い」は、必ず来ます。
src/pages/NotFoundPage.jsx(新規)
import { Link } from "react-router-dom";
function NotFoundPage() {
return (
<div className="board">
<h2>ページが見つかりません</h2>
<p className="empty">そのURLに対応する画面はありません。</p>
<p>
<Link to="/">← 一覧に戻る</Link>
</p>
</div>
);
}
export default NotFoundPage;
src/App.jsx(丸ごと置き換え)
import { useReducer, useState, useMemo } from "react";
import { Routes, Route } from "react-router-dom";
import { UserContext } from "./contexts/UserContext.js";
import { tasksReducer, initialTasks } from "./tasksReducer.js";
import Header from "./components/Header.jsx";
import TaskListPage from "./pages/TaskListPage.jsx";
import TaskDetailPage from "./pages/TaskDetailPage.jsx";
import NotFoundPage from "./pages/NotFoundPage.jsx";
function App() {
const [tasks, dispatch] = useReducer(tasksReducer, initialTasks);
const [user, setUser] = useState("たろう");
const userValue = useMemo(() => ({ user, setUser }), [user]);
return (
<UserContext.Provider value={userValue}>
<div className="app">
<Header user={user} />
<Routes>
<Route path="/" element={<TaskListPage tasks={tasks} dispatch={dispatch} />} />
<Route path="/tasks/:id" element={<TaskDetailPage tasks={tasks} dispatch={dispatch} />} />
<Route path="*" element={<NotFoundPage />} />
</Routes>
<button
className="switch"
onClick={() => setUser(user === "たろう" ? "はなこ" : "たろう")}
>
使う人を切り替える
</button>
</div>
</UserContext.Provider>
);
}
export default App;
<Routes> の3行が、この記事のすべてです。「この URL のときは、この画面」という対応表でしかありません。
| 書いたもの | 意味 |
|---|---|
path="/" | ちょうど / のとき |
path="/tasks/:id" | /tasks/ の後ろに何か1つあるとき。 その何かが id という名前で受け取れる |
path="*" | 上のどれにも当てはまらないとき。 順番ではなく「一致度」で選ばれるので、一番下に書かなくても動きますが、読みやすさのために一番下に書きます |
そして、<Routes> の外に注目してください。
<Header user={user} />
<Routes> ... </Routes>
<button className="switch"> ... </button>
<Routes>の外に書いたものは、どの画面でも消えません。 ヘッダーと「使う人を切り替える」ボタンは、詳細画面に移っても出たままです。「画面ごとに変わる部分」だけを<Routes>の中に入れる、という考え方です。
もう1つ、重要なことがあります。
tasksは、いまもAppが持っています。 画面を移っても、状態は消えません。Appは<Routes>の外にいるので、URL が変わってもAppは作り直されないからです。前回までに作った状態の置き場所は、1つも変わっていません。
src/components/TaskItem.jsx(丸ごと置き換え)
一覧から詳細へ行く道を作ります。
import { Link } from "react-router-dom";
import TaskMeta from "./TaskMeta.jsx";
function TaskItem({ task, onToggle, onRemove }) {
return (
<li>
<span
onClick={() => onToggle(task.id)}
className={task.done ? "done" : ""}
>
{task.title}
</span>
<Link to={`/tasks/${task.id}`} className="detail">詳細</Link>
<button onClick={() => onRemove(task.id)}>削除</button>
<TaskMeta task={task} />
</li>
);
}
export default TaskItem;
to={/tasks/${task.id}} のバッククォートはテンプレートリテラルです。task.id が 3 なら /tasks/3 という文字列になります。
src/index.css(丸ごと置き換え)
body {
font-family: sans-serif;
margin: 2rem;
line-height: 1.7;
}
.done {
text-decoration: line-through;
color: #888;
}
li span {
cursor: pointer;
}
.empty {
color: #888;
}
.header {
border-bottom: 1px solid #ddd;
margin-bottom: 1rem;
}
.who {
color: #666;
font-size: 0.9rem;
margin-top: -0.5rem;
}
.board {
border: 1px solid #ddd;
border-radius: 6px;
padding: 1rem;
}
.meta {
display: block;
color: #999;
font-size: 0.8rem;
cursor: auto;
}
.switch {
margin-top: 1rem;
}
.bulk {
margin-top: 1rem;
display: flex;
gap: 0.5rem;
}
.detail {
margin-left: 0.5rem;
font-size: 0.85rem;
}
.filters {
display: flex;
gap: 0.5rem;
margin-bottom: 0.5rem;
}
.filters は、この後⑥で使います。 先に入れておきます。
動かす
ブラウザで、次の順に確かめてください。
- 一覧に3件出ている(牛乳を買う / ルーティングを試す / ゴミを出す)
- 「ルーティングを試す」の横の「詳細」を押す → URL が
/tasks/2に変わり、詳細画面が出る - 「完了にする」を押す → 取り消し線が付く
- 「← 一覧に戻る」で戻る → 一覧でも、そのタスクに取り消し線が付いている
- ブラウザの「←」(戻る)を押す → 詳細画面に戻る。今度はアプリの中で動く
- アドレスバーに直接
/tasks/99と打つ → 「そのタスクはありません」 - アドレスバーに直接
/zzzと打つ → 「ページが見つかりません」
[スクリーンショット: 02_詳細画面.png] /tasks/2 の詳細画面を撮ってください。アドレスバーの /tasks/2 と、画面の「id: 2」が両方写る形で。
3と4に注目してください。 詳細画面で押した「完了にする」が、一覧にも反映されています。 tasks は App が1つだけ持っているからです。画面が2枚になっても、信頼できる唯一の情報源は1つのままです。
6と7の違いも重要です。
| URL | 出る画面 | 誰が判断したか |
|---|---|---|
/tasks/99 | そのタスクはありません | TaskDetailPage。ルートには一致している。データが無かった |
/zzz | ページが見つかりません | ルーター。どのルートにも一致しなかった |
似た文言ですが、原因が全然違います。 前者は「URL の形は正しいが、中身が無い」、後者は「URL の形からして知らない」です。
⑤ <a href> を使わない理由
<Link to="/"> を見て、こう思ったはずです。
「
<a href="/">でいいのでは?」
見た目は同じです。 実際、ブラウザに出来上がるのも <a> タグです。それでも、絶対に <a href> にしてはいけません。
実際に壊す
src/pages/NotFoundPage.jsx の <Link to="/"> を、一時的に <a href="/"> に書き換えます。
// ❌ 一時的に、わざとこうします
import { Link } from "react-router-dom";
function NotFoundPage() {
return (
<div className="board">
<h2>ページが見つかりません</h2>
<p className="empty">そのURLに対応する画面はありません。</p>
<p>
<a href="/">← 一覧に戻る(a href版)</a>
</p>
</div>
);
}
export default NotFoundPage;
import { Link }は残したままで構いません。 使っていない import があっても動きます(Console に警告が出ることはあります)。すぐ戻すので、そのままにします。
確かめる手順は、ここが肝心です。
- 一覧で、新しいタスクを1件追加してください(例: 「これは消えるはず」)。4件になります
- 「使う人を切り替える」を押して、「はなこ」にしてください
- 開発者ツールの Console で
history.pushState(null, "", "/zzz"); dispatchEvent(new PopStateEvent("popstate"));と打って、「ページが見つかりません」を出す(アドレスバーに直接打つとページ全体が読み込み直され、<a href>を押す前に状態が消えてしまうため) - 「← 一覧に戻る(a href版)」を押す
何が起きたか。
- 画面が一瞬、白く点滅しました
- 追加した4件目が消えています。3件に戻っています
- 「ログイン中」が「たろう」に戻っています
[スクリーンショット: 03_aタグで状態が消える.png] a href のリンクで戻った直後の画面を撮ってください。タスクが3件に戻り、ヘッダーが「ログイン中: たろう」に戻っているのが分かる形で。
何が起きたのか
<a href>は、ブラウザに「そのURLを、サーバーに取りに行け」と命令します。 ブラウザは、いま動いている JavaScript を全部捨てて、HTMLを取り直し、React を最初から起動し直します。
React が持っていた tasks も user も、JavaScript の変数でしかありません。 ページを読み込み直せば、変数は初期値に戻ります。
<Link> は、これをやりません。
<a href="/tasks/3"> ブラウザが動く → サーバーに取りに行く → 全部作り直し → 状態が消える
<Link to="/tasks/3"> React が動く → URL だけ書き換える → 画面だけ差し替え → 状態は残る
<Link> の中身は、だいたいこういうことをしています。
<a>タグとして表示する(だから右クリックで「新しいタブで開く」も効くし、読み上げソフトもリンクとして読む)- クリックされたら
e.preventDefault()で、ブラウザ本来の動きを止める - History API で、URL の表示だけを書き換える
- React に「URL が変わった」と伝え、対応する画面に差し替える
2の e.preventDefault() は、DOM操作の回と前回のフォームで出てきたものです。同じ道具が、ここでも効いています。
重要なのは、3です。 History API は「URL の表示を書き換える」だけで、サーバーには何も聞きません。 これが、この後の 404 の直接の原因になります。ブラウザのアドレスバーに
/tasks/3と出ていても、そのURLをサーバーに要求したことは一度もないからです。
使い分け
| 行き先 | 使うもの |
|---|---|
| 同じアプリの中の画面 | <Link to="..."> |
| 外部サイト(ja.react.dev など) | <a href="...">。ルーターは関係ない |
| ファイルのダウンロード、PDF | <a href="...">。React で表示するものではない |
<a href> を使うこと自体が悪いのではありません。 「アプリの中の移動なのに <a href> を使う」のが事故です。
戻してください。
<Link to="/">← 一覧に戻る</Link>
Header.jsxの<h1>やること</h1>も、<Link to="/">で包むと、どの画面からでも一覧に戻れるようになります。 余力があればやってみてください。この記事では触りません。
⑥ URL も状態のひとつ — 絞り込みをURLに置く
機能を1つ足します。 「すべて / 未完了 / 完了」の絞り込みです。
ここで、前回からの問いを繰り返します。
useStateに入れる前に「これ、リンクで共有したい情報ではないか」と聞いてください。
絞り込み条件は、共有したい情報です。 「未完了だけの一覧、これ見といて」は、普通に起きます。
そして、URL に置くための道具が useSearchParams です。
src/pages/TaskListPage.jsx(丸ごと置き換え)
import { useSearchParams } from "react-router-dom";
import Board from "../components/Board.jsx";
import TaskForm from "../components/TaskForm.jsx";
import TaskSummary from "../components/TaskSummary.jsx";
import TaskList from "../components/TaskList.jsx";
function TaskListPage({ tasks, dispatch }) {
const [searchParams, setSearchParams] = useSearchParams();
const filter = searchParams.get("filter") || "all";
const shown = tasks.filter((t) => {
if (filter === "done") return t.done;
if (filter === "todo") return !t.done;
return true;
});
return (
<Board>
<TaskForm onAdd={(title) => dispatch({ type: "added", title })} />
<div className="filters">
<button onClick={() => setSearchParams({})}>すべて</button>
<button onClick={() => setSearchParams({ filter: "todo" })}>未完了</button>
<button onClick={() => setSearchParams({ filter: "done" })}>完了</button>
</div>
<TaskSummary tasks={tasks} />
<TaskList
tasks={shown}
onToggle={(id) => dispatch({ type: "toggled", id })}
onRemove={(id) => dispatch({ type: "removed", id })}
/>
<div className="bulk">
<button onClick={() => dispatch({ type: "completedAll" })}>
全部完了にする
</button>
<button onClick={() => dispatch({ type: "clearedDone" })}>
完了したものを消す
</button>
</div>
</Board>
);
}
export default TaskListPage;
useSearchParams は、useState にそっくりな形をしています。
useState | useSearchParams | |
|---|---|---|
| 読む | const [filter] = useState("all") | searchParams.get("filter") |
| 書く | setFilter("done") | setSearchParams({ filter: "done" }) |
| 値の置き場所 | メモリ。リロードで消える | URL。共有できる・戻れる・残る |
searchParams.get("filter") が null を返すのは、?filter=... が付いていないときです。だから || "all" で既定値にしています。
TaskSummary には、絞り込む前の tasks を渡していることに注意してください。「未完了だけ表示中でも、全体の件数は全体のまま」にするためです。どちらが正しいかは仕様次第ですが、「何を数えているのか」を決めるのは自分です。
確かめる
- 「未完了」を押す → URL が
/?filter=todoになり、完了済みの「ゴミを出す」が消える - 「完了」を押す →
/?filter=doneになり、「ゴミを出す」だけになる - ブラウザの「←」(戻る)を押す →
/?filter=todoに戻り、表示も戻る - その URL をコピーして、別のタブに貼る → 同じ絞り込みで開く
[スクリーンショット: 04_URLに絞り込みが出る.png] 「完了」で絞り込んだ状態を撮ってください。アドレスバーの ?filter=done と、1件だけの一覧が同時に写る形で。
3が、この節のすべてです。「戻る」で絞り込みが戻りました。 これを useState で作ると、自分で履歴を管理することになります。 URL に置いたので、ブラウザがただでやってくれています。
何を URL に置き、何を置かないか
全部 URL に置けばいい、という話ではありません。
| 例 | どこに置くか |
|---|---|
| いま見ている画面、詳細の id | URL のパス(/tasks/3) |
| 絞り込み、並び順、ページ番号、検索語 | URL のクエリ(?filter=done&page=2) |
| 入力途中の文字 | useState。1文字打つたびに URL が変わるのは異常 |
| メニューが開いているか | useState。共有する意味がない |
| ログイン用のトークン、パスワード | 絶対に URL に置かない(後述) |
URL は、あちこちに残ります。 ブラウザの履歴、サーバーのアクセスログ、リンク元として次のサイトに送られる情報。 認証の回で扱うトークンのような秘密を URL に入れると、それが全部に残ります。 「共有していい情報だけを URL に置く」が判断基準です。
⑦ 画面のURLと、APIのURLは別物
ここで、混同しやすいものを整理します。
REST APIの回で、こういうURLを設計しました。
GET /api/tasks/3
今日作ったのは、これです。
/tasks/3
そっくりです。 そして、まったくの別物です。
画面のURL /tasks/3 | APIのURL /api/tasks/3 | |
|---|---|---|
| 誰が開くか | 人間。ブラウザのアドレスバーに出る | プログラム。fetch が呼ぶ |
| 返ってくるもの | HTML(正確には、後述のとおり index.html 1枚) | JSON |
| 決めるのは誰か | フロントエンドの担当(<Route path=...>) | バックエンドの担当(サーバーのコード) |
| 一致している必要は | ありません。まったく別に決めて構いません | 同上 |
この2つが「たまたま似ている」のは、どちらも「タスクの3番」を指しているからです。似せて書くのは読みやすさのためであって、決まりではありません。
実際、こういう組み合わせは普通にあります。
画面: /tasks/3 → API: /api/v1/todo-items/3
画面: /u/taro/posts/12 → API: /api/posts/12
なぜ、ここを強調するのか。 「画面のURLを変えたらAPIも変えないといけないのでは」と考えて、手が止まる人がいるからです。関係ありません。 逆も同じです。 API のパスを
/api/v2/...に変えても、画面のURLは1文字も変わりません。
将来、この2つは同じサーバーが返すことになります。
/api/ で始まるもの → API のプログラムに渡す(JSON が返る)
それ以外 → dist/ の中の静的ファイルを返す
この振り分けをやるのが、nginx のリバースプロキシです。第6段階でやったことが、ここで繋がります。
⑧ ビルドして配ると、404が出る
ここからが、この記事の本番です。
ビルドツールの回で、こう予告しました。
ページ内でURLを切り替えるタイプのアプリ(SPA)を配ると、
/aboutに直接アクセスしたときに 404 になります。 今は「そういう罠がある」とだけ覚えておいてください。
いま、まさに「ページ内でURLを切り替えるタイプのアプリ」を作りました。 起こします。
まず、ビルドする
開発サーバーを Ctrl+C で止めて、VMの中で、
vite v7.0.4 building for production...
✓ 62 modules transformed.
dist/index.html 0.46 kB │ gzip: 0.30 kB
dist/assets/index-BjK2p0Lq.css 1.31 kB │ gzip: 0.62 kB
dist/assets/index-Cw8tRn5X.js 235.18 kB │ gzip: 76.04 kB
✓ built in 1.42s
中身を見ます。
dist:
assets index.html vite.svg
dist/assets:
index-BjK2p0Lq.css index-Cw8tRn5X.js
ここを、よく見てください。
tasksというディレクトリは、ありません。tasks/3というファイルも、ありません。index.htmlが1枚と、JS と CSS が1本ずつ。それだけです。ビルドツールの回で見たものと、何も変わっていません。
画面は3枚あるはずなのに、HTMLは1枚しかない。 これが SPA(Single Page Application、ページ1枚のアプリ)という名前の意味です。
静的に配る
ビルドツールの回と同じやり方で配ります。 Vite も npm も使いません。
ホストのブラウザで http://192.168.226.50:8000/ を開いてください。
普通に動きます。 一覧が出て、「詳細」を押せば /tasks/2 に移り、詳細画面も出ます。 戻るボタンも効きます。
ここまでは、開発サーバーと何も変わりません。
そして、壊す
/tasks/2 を表示したまま、ブラウザの再読み込み(F5)を押してください。
Error response
Error code: 404
Message: File not found.
Error code explanation: 404 - Nothing matches the given URI.
アドレスバーに直接 http://192.168.226.50:8000/tasks/3 と打っても、同じです。
[スクリーンショット: 05_直接アクセスで404.png] /tasks/3 に直接アクセスして 404 が出ている画面を撮ってください。アドレスバーのURLが読める形で。
VMのターミナルも見てください。 python3 -m http.server が、何が起きたかを1行で出しています。
192.168.226.60 - - [05/Sep/2026 14:22:31] "GET / HTTP/1.1" 200 -
192.168.226.60 - - [05/Sep/2026 14:22:31] "GET /assets/index-Cw8tRn5X.js HTTP/1.1" 200 -
192.168.226.60 - - [05/Sep/2026 14:23:02] code 404, message File not found
192.168.226.60 - - [05/Sep/2026 14:23:02] "GET /tasks/3 HTTP/1.1" 404 -
なぜ、リンクで行けたのに、リロードすると死ぬのか
この差が、すべてです。
| やったこと | サーバーへの要求 | 結果 |
|---|---|---|
| 一覧から「詳細」を押した | 無し。 <Link> は History API で URL を書き換えただけ | JS が中で画面を差し替えた。動く |
/tasks/3 をリロードした | GET /tasks/3 が飛ぶ | そんなファイルは無い → 404 |
サーバーは、正しく答えています。
dist/の中にtasks/3というファイルはありません。 「無い」と言うのが、サーバーの正しい仕事です。 ルーティングの表(<Route path="/tasks/:id">)は、index.htmlが読み込む JavaScript の中に書いてあります。 その JavaScript は、index.htmlが返ってきて初めて動きます。index.htmlが返らなければ、React は起動すらしていません。
順番で書くと、こうです。
リロード
└─ ブラウザ:「/tasks/3 をください」
└─ サーバー: dist/tasks/3 を探す → 無い → 404
└─ React は1行も動いていない
└─ ルーティングの表を読む機会が、そもそも無い
「React のルーティングが壊れている」のではありません。 React にたどり着く前に終わっています。
npm run preview では見つからない
ここが、この罠のいやらしいところです。
Ctrl+C で止めて、Vite の preview で試してください。
http://192.168.226.50:4173/tasks/3 を開くと — 動きます。 404 になりません。
npm run previewは、この後やる「フォールバック」を最初から内蔵しているからです。npm run devも同じです。 つまり、開発中も preview も、この問題を隠してくれます。 本番に置いた瞬間に、初めて出ます。
ビルドツールの回で「npm run dev で動くのに npm run preview で壊れる、はよくあります」と書きました。 その1段上があった、ということです。
previewで動いた = 本番で動く、ではありません。previewが確かめてくれるのは「ビルドしたJSが正しく動くか」までで、「配るサーバーの設定が正しいか」は確かめていません。
Ctrl+C で preview を止めてください。
⑨ 直す — 「見つからなければ index.html を返す」
直し方は、React 側ではありません。配るサーバー側です。
dist/の中に無いURLを要求されたら、404 を返さずにindex.htmlを返す。
これで何が起きるか。
ブラウザ:「/tasks/3 をください」
└─ サーバー: 無い → でも index.html を返す(200 OK)
└─ ブラウザ: HTML を読む → JS を読む → React 起動
└─ React:「いまのURLは /tasks/3 だな」→ TaskDetailPage を出す
アドレスバーは /tasks/3 のままです。 React は起動したあとで、自分でURLを見て、正しい画面を選びます。
この「見つからなければ index.html」を、フォールバックと呼びます。
手を動かして直す
python3 -m http.server には、この設定がありません。 15行ほど書けば作れるので、書きます。
VMの中で、~/react-demo/spa-server.py を新規作成します。
import http.server
import os
import socketserver
PORT = 8000
ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "dist")
class SpaHandler(http.server.SimpleHTTPRequestHandler):
def __init__(self, *args, **kwargs):
super().__init__(*args, directory=ROOT, **kwargs)
def do_GET(self):
if not os.path.exists(self.translate_path(self.path)):
self.path = "/index.html"
return super().do_GET()
socketserver.TCPServer.allow_reuse_address = True
with socketserver.TCPServer(("0.0.0.0", PORT), SpaHandler) as httpd:
print("http://0.0.0.0:" + str(PORT) + "/ で dist を配っています (Ctrl+C で停止)")
httpd.serve_forever()
やっていることは、真ん中の4行だけです。
def do_GET(self):
if not os.path.exists(self.translate_path(self.path)):
self.path = "/index.html"
return super().do_GET()
「要求されたパスに、実際のファイルが無ければ、/index.html を要求されたことにする」。それだけです。
動かします。 dist/ の中ではなく、~/react-demo/ で打ちます。
http://0.0.0.0:8000/ で dist を配っています (Ctrl+C で停止)
ブラウザで http://192.168.226.50:8000/tasks/3 を、直接開いてください。
「ゴミを出す」の詳細画面が出ます。
[スクリーンショット: 06_フォールバック後.png] /tasks/3 に直接アクセスして詳細画面が出ているところを撮ってください。アドレスバーの /tasks/3 が読める形で。
ターミナルのログも見てください。 さっき 404 だった行が、200 に変わっています。
192.168.226.60 - - [05/Sep/2026 14:31:10] "GET /tasks/3 HTTP/1.1" 200 -
/zzz も試してください。 「ページが見つかりません」の画面が出ます。
ここが、初心者が必ず引っかかる点です。
/zzzの HTTP の返事は、404 ではなく 200(成功)です。 サーバーはindex.htmlを「正しく」返しているからです。 画面には「ページが見つかりません」と出ているのに、200。 開発者ツールの Network タブで確かめられます。 これは SPA の避けがたい弱点です。検索エンジンには「そのページは存在する」と見えます。 本気で直すには、サーバー側でHTMLを組み立てる仕組み(SSR)が要ります。この記事の範囲を超えるので、「そういう限界がある」とだけ覚えてください。
Ctrl+C で止めてください。
本番では、nginx の1行で済む
Python で書いたのは、仕組みを見るためです。実際の本番では、第6段階の nginx が、これを1行でやります。
location / {
root /var/www/react-demo;
try_files $uri $uri/ /index.html;
}
try_files の読み方は、そのまま「順に試す」です。
| 順番 | 試すもの |
|---|---|
| 1 | $uri — 要求されたパスのファイル(/assets/index-Cw8tRn5X.js など) |
| 2 | $uri/ — 同じ名前のディレクトリ |
| 3 | /index.html — どれも無ければ、これを返す |
さっき Python で書いた if not os.path.exists(...) と、まったく同じことです。書く場所と量が違うだけです。
1と2を先に試すのが重要です。 いきなり全部
index.htmlにすると、JS も CSS も画像もindex.htmlになります。 その症状は「真っ白な画面 + Console にUncaught SyntaxError: Unexpected token '<'」です。JavaScript のつもりで HTML を読まされている、という意味です。
他の直し方
| やり方 | 内容 | 使うとき |
|---|---|---|
| サーバー側のフォールバック | 上のとおり。本命 | サーバーの設定を触れるとき |
HashRouter に変える | URL が /#/tasks/3 になる。# より後ろはサーバーに送られないので、要求されるのは常に /。設定が一切要らない | サーバーの設定を触れないとき(社内の共有フォルダに置くだけ、など) |
| ホスティングサービスの設定ファイル | Netlify なら _redirects、Vercel なら vercel.json で同じことを指定する | そのサービスを使うとき |
HashRouter は、main.jsx の BrowserRouter を差し替えるだけで試せます。
import { HashRouter } from 'react-router-dom'
URL が http://192.168.226.50:8000/#/tasks/3 のように、# 付きになります。 見た目が悪く、検索エンジンにも扱いにくいので、選べるなら BrowserRouter + フォールバックです。試したら戻してください。
なぜ
#だと大丈夫なのか。#から後ろは「フラグメント」と呼ばれ、HTTP の要求に含まれません。 ブラウザの中だけで完結します。 サーバーから見れば、いつでも/を要求されているだけです。だから 404 になりようがありません。
⑩ もう1つの「動くのに壊れている」
フォールバックを入れて安心したところで、もう1つあります。
/tasks/3 を直接開いた画面を、よく見てください。
動いてはいます。 ですが、この記事の最初に自分で追加したタスクは、どこにもありません。 initialTasks の3件だけです。
URL は共有できるようになりました。 データは、まだ共有できていません。
tasksはuseReducerの中、つまりブラウザのメモリにしかありません。 リロードすれば初期値に戻り、他人のブラウザにはそもそも存在しません。
これは、ルーティングでは解けません。 前回の表の、この行です。
| 種類 | 持ち主 | 使う道具 |
|---|---|---|
| サーバーの状態(実体はキャッシュ) | サーバー | TanStack Query / SWR |
/tasks/3 を開いたら、APIから3番を取ってくる。 そうして初めて、URL が本当に共有できるものになります。
やるべきことは、はっきりしています。
3の入り口が、今日できました。 useParams() が返す id は、そのまま API のURLに埋める材料です。
// この先、こうなります(今日は書きません)
const { id } = useParams();
// fetch(`/api/tasks/${id}`) → JSON を受け取って表示する
「URL から id を取り出す」ところまでが、今日の仕事です。
つまずいたところ
useNavigate() may be used only in the context of a <Router> component → main.jsx の <BrowserRouter> が抜けています。 <Link> も useParams も、<BrowserRouter> の内側でしか使えません。
Failed to resolve import "react-router-dom" → npm install react-router-dom を打っていないか、別のディレクトリで打っています。 cd ~/react-demo してから打ち直してください。npm ls react-router-dom で確かめられます。
詳細画面が、必ず「そのタスクはありません」になる → t.id === id で比べています。 useParams() が返すのは文字列です。String(t.id) === id にしてください。 ④で書いたとおりです。
Cannot read properties of undefined (reading 'title')(詳細画面で) → if (!task) を書いていません。 /tasks/999 のような、存在しない id が来たときに落ちます。
<Route> を書いたのに、画面が真っ白 → <Route> を <Routes> で囲んでいますか。 <Routes> の直接の子は <Route> だけです。間に <div> を挟むと動きません。
詳細画面に移ると、ヘッダーまで消える → <Header /> を <Routes> の中に入れています。 どの画面でも出したいものは、<Routes> の外に置きます。
「詳細」を押すと、追加したタスクが全部消える → <Link to=...> ではなく <a href=...> になっています。 ⑤のとおりです。
リロードすると 404(python3 -m http.server で配っているとき) → 正常です。 ⑧の症状そのものです。⑨の spa-server.py で配り直してください。
spa-server.py を動かしたが dist が見つからない、と出る → npm run build をしていないか、~/react-demo/ 以外の場所に置いています。 spa-server.py は dist/ と同じ階層(~/react-demo/)に置いてください。
OSError: [Errno 98] Address already in use → さっきの python3 -m http.server が、まだ動いています。 そのターミナルで Ctrl+C を押すか、pkill -f http.server で止めてください。プロセスの回でやった話です。
画面が真っ白で、Console に Uncaught SyntaxError: Unexpected token '<' → フォールバックが効きすぎています。 JS や CSS まで index.html を返しています。 「実在するファイルは、そのまま返す」を先に書いてください(nginx なら try_files $uri $uri/ /index.html; の $uri の部分)。
ホストのブラウザから 8000番に繋がらない → sudo ufw allow 8000/tcp の忘れか、--bind 0.0.0.0 の付け忘れです。①に戻ってください。
アドレスバーに ?filter=done が出ない → setSearchParams ではなく useState を使っています。 ⑥のとおりです。
後片づけ
開けたポートを閉じます。
ビルドの成果物は消して構いません。
ビルドツールの回で書いたとおり、dist/ は「毎回作り直せる、捨てていいもの」です。spa-server.py は、この先も使うので残してください。
最終的なファイル構成は、こうなっています。
/home/user/react-demo/src:
App.css App.jsx assets components contexts index.css main.jsx pages tasksReducer.js
/home/user/react-demo/src/components:
Board.jsx Header.jsx TaskForm.jsx TaskItem.jsx TaskList.jsx TaskMeta.jsx TaskSummary.jsx
/home/user/react-demo/src/contexts:
UserContext.js
/home/user/react-demo/src/pages:
NotFoundPage.jsx TaskDetailPage.jsx TaskListPage.jsx
全部やり直したいときは:
~/vite-demo/(Vanilla)と ~/web/(素のHTML)も、まだ消さないでください。
まとめ
- 画面が1枚でも、ルーティングは必要になる。 「いま何を見ているか」を
useStateに持つと、戻るボタン・共有・ブックマークが全部使えなくなる - ルーターがやっているのは1つだけ。 URL を状態として扱い、その値で出すコンポーネントを切り替える
<BrowserRouter>は、Context で「いまのURL」を配っているだけ。 前回のProviderと同じ形<Routes>の外に置いたものは、画面が変わっても消えない。 ヘッダーや共通のボタンはそこに置く- 状態は
Appに残したまま。 ルーティングを入れても、状態の置き場所の考え方は1つも変わらない useParams()が返す値は、必ず文字列。t.id === idは永久にfalse。String(t.id) === idにする- URL は、ユーザーが自由に書き換えられる入力欄。 「そんな id は無い」を必ず書く
- 「見つかりません画面」と「404」は別物。 前者は React が出す画面で、HTTP としては 200
<a href>はページを丸ごと読み込み直す。 React の状態が全部消える。 アプリ内の移動は必ず<Link><Link>は<a>として表示し、クリックをpreventDefault()して、History API で URL だけ書き換えている- 絞り込みや並び順は URL に置く。 戻るボタンも共有も、ブラウザがただでやってくれる
- 入力途中の文字やメニューの開閉は
useStateのまま。 秘密の情報は絶対に URL に置かない - 画面のURL
/tasks/3と、APIのURL/api/tasks/3は別物。 似せるのは読みやすさのためで、一致させる義務はない - ビルドすると HTML は1枚しか出ない。
dist/にtasks/3というファイルは存在しない /tasks/3を直接開くと 404 になるのは、サーバーが正しく答えているから。 React はまだ1行も動いていない- リンクで行けるのにリロードで死ぬのは、
<Link>がサーバーに何も聞いていないから - 直すのはサーバー側。 「見つからなければ
index.htmlを返す」(nginx ならtry_files $uri $uri/ /index.html;) - 実在するファイルを先に試すこと。 全部
index.htmlにすると、JS まで HTML になって真っ白になる npm run devもnpm run previewも、この罠を隠す。 フォールバックを内蔵しているから。 preview で動いた = 本番で動く、ではない- URL が共有できるようになっても、データはまだ共有できていない。 それはサーバーの仕事
参考リンク
- roadmap.sh — React(Routing の項目)
- roadmap.sh — Frontend
- React Router — 公式ドキュメント
- React Router — Routing
- React Router — Navigating
- MDN — History API
- MDN — HTTP レスポンスステータスコード
- Vite — 静的サイトのデプロイ
- nginx — try_files
- React —
useState
次に読む
この記事は 【第4段階】フロントエンド の 4 / 15 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- React Router
- SPA のURL設計
- ホスティング時のフォールバック
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント