DOM操作の回で、入力欄に打った文字をリストに追加するものを作りました。あれは動いていました。
前回: dist/ の中身は何なのか — ビルドツールとVite この記事から第4段階(フレームワーク)です。 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。
そこに、あと2つだけ機能を足してみます。
- 各行に「削除」ボタン
- 画面のどこかに「残り◯件」の表示
これだけで壊れます。 正確には、壊れはしないのですが、「同じことを何箇所にも書く」羽目になり、そのうち1箇所を書き忘れて、画面と実際の中身がずれます。
この記事は「React の使い方」ではありません。「なぜフレームワークという道具が生まれたのか」を、自分が書いた素の JavaScript の限界から辿る記事です。そこを飛ばして React から入ると、React が便利なのか、それとも自分がやらなくて済んでいるだけなのかが、一生わかりません。
前回の最後にこう書きました。
フレームワークが何を代わりにやってくれているのかを判断するには、代わりにやってもらう前の姿を知っている必要がある
その「前の姿」を、この記事の前半でもう一度だけ書きます。 後半で、それを React に置き換えます。
似たタイトルの記事があります。役割が違います。 この記事はフレームワークが要る理由と、3つの違いを扱います。Svelte・Solid・Qwikの比較|仮想DOMを使わない実装 は仮想DOMを使わない実装(Svelte・Solid・Qwik)の現在地を扱います。
対象レベル: 初級 / 区分: 必修
この記事でわかること
- フレームワークが解いている問題は「描画」ではなく「状態と表示を一致させ続けること」だということ
- React・Vue・Svelte に優劣はないこと。違うのは書き方と、更新をいつ計算するか
- JSX は HTML ではないこと。
classが書けないのも、returnが1つしか返せないのも、JSX が JavaScript だからであること - 仮想DOMは「速くする仕組み」ではないこと。速さではなく書き方を変えるためのもの
- この段階で状態管理ライブラリやUIライブラリを入れてはいけない理由
この記事でやること
- DOM操作の回のコードに「削除」と「件数」を足して、何が苦しくなるかを自分の手で確かめる
- React / Vue / Svelte の違いを並べて見て、この順路で React を選ぶ理由を確認する
- VMの中で
npm create vite@latestを実行し、今度は React でプロジェクトを作る(前回の Vanilla との差分を見る) sudo ufw allow 5173/tcpでポートを開け直し、npm run dev -- --host 0.0.0.0でホストのブラウザから開く- 手順1と同じものを React で書き直し、2つのコードを並べて「何が消えたか」を見る
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 状態(state) | 画面を組み立てるのに必要なデータ。「タスクの配列」「入力欄の中身」など |
| 宣言的(declarative) | 「こういう見た目にしたい」だけを書くやり方。「どう書き換えるか」は書かない |
| 命令的(imperative) | 「これをこう書き換えろ」と手順を書くやり方。textContent = ... はこちら |
| コンポーネント | 見た目と、その見た目が使う状態を、ひとまとまりにした部品。関数1つで書く |
| 再レンダリング | 状態が変わったときに、その部品の見た目をもう一度計算し直すこと |
| 仮想DOM | 本物のDOMではなく、JavaScriptのオブジェクトで作った「見た目の設計図」。前と比べて差分だけ本物に反映する |
| JSX | JavaScript の中に、HTMLに似た書き方で見た目を書ける文法。ブラウザは読めないので変換が要る |
| フレームワーク | 呼び出す道具(ライブラリ)ではなく、こちらが書いた関数を向こうが呼びに来るもの |
ライブラリとフレームワークの違いは、「どちらが主導権を持つか」です。 ライブラリは、自分のコードから呼ぶもの(
fetchを呼ぶ、みたいな)。 フレームワークは、自分が書いた関数を向こうが呼びに来るもの。「状態が変わったので、あなたの関数をもう一度呼びます」という主導権の逆転が起きます。 React は自称としては「ライブラリ」ですが、この主導権の逆転は完全に起きています。 ここが最初のつまずきどころです。
① 素のJavaScriptで、何が苦しくなるのか
まず、フレームワーク無しで書きます。 読むだけでも構いませんが、実際に打つと痛みが分かります。
DOM操作の回で作った ~/web/index.html の <article id="demo"> を、こうします。
<input type="text" id="input" placeholder="何か入力">
<button id="add">追加</button>
<p id="counter">残り 0 件</p>
<ul id="list"></ul>
~/web/script.js を丸ごと置き換えます(前の回の btn や message は使いません)。
const input = document.querySelector("#input");
const addBtn = document.querySelector("#add");
const list = document.querySelector("#list");
const counter = document.querySelector("#counter");
let tasks = [];
addBtn.addEventListener("click", () => {
const text = input.value;
if (text === "") return;
const task = { id: Date.now(), title: text, done: false };
tasks.push(task);
// ---- ここから、画面に反映するための手順 ----
const li = document.createElement("li");
const span = document.createElement("span");
span.textContent = task.title;
span.addEventListener("click", () => {
task.done = !task.done;
span.style.textDecoration = task.done ? "line-through" : "none";
counter.textContent = `残り ${tasks.filter((t) => !t.done).length} 件`;
});
const del = document.createElement("button");
del.textContent = "削除";
del.addEventListener("click", () => {
tasks = tasks.filter((t) => t.id !== task.id);
li.remove();
counter.textContent = `残り ${tasks.filter((t) => !t.done).length} 件`;
});
li.appendChild(span);
li.appendChild(del);
list.appendChild(li);
input.value = "";
counter.textContent = `残り ${tasks.filter((t) => !t.done).length} 件`;
});
動きます。 python3 -m http.server 8000 で配って(ポートを閉じたなら sudo ufw allow 8000/tcp)、ホストのブラウザで触ってみてください。追加できて、クリックで取り消し線がついて、削除できて、件数も合っています。
では、何が苦しいのか
同じ行が3回出てきています。
counter.textContent = `残り ${tasks.filter((t) => !t.done).length} 件`;
追加したとき・完了にしたとき・削除したとき。 どれか1箇所でも書き忘れると、画面の数字だけが古いままになります。
そして、これはまだ機能が3つしかないから3箇所で済んでいるだけです。
| 足したい機能 | この書き方だと |
|---|---|
| 「全部完了」ボタン | 全部の span を辿って取り消し線を付け直す + 件数の更新をもう1箇所 |
| 「完了だけ隠す」チェック | 全部の li を辿って display を切り替える処理を書く |
| 並べ替え | DOMの順番を入れ替える処理を、appendChild で書き直す |
| 保存して再読み込み後も残す | 配列から画面を組み立て直す処理を、追加時とは別にもう1つ書く |
機能が1つ増えるたびに、「反映すべき場所」が増えます。 掛け算で増えます。
そして根本の問題はここです。
同じ情報が、2箇所にある。 1つは
tasksという配列。もう1つは、画面に並んでいるDOM。 この2つを一致させ続ける責任を、全部自分が背負っています。
これが「状態と表示がずれる」という言葉の中身です。バグの原因ではありません。バグの形そのものです。
素のJSでも解決はできる(そして、そこが入口)
やり方はあります。「毎回、全部作り直す」です。
function render() {
list.innerHTML = "";
for (const task of tasks) {
const li = document.createElement("li");
// ...(省略)
list.appendChild(li);
}
counter.textContent = `残り ${tasks.filter((t) => !t.done).length} 件`;
}
tasks を変えたら render() を呼ぶ。それだけ。 反映漏れは起きません。tasks が唯一の正になります。
考え方としては、これが正解です。 ただし、素のDOMでやると3つ問題が出ます。
| 問題 | 中身 |
|---|---|
| 重い | 100行あれば100行ぜんぶ作り直す。1文字変えただけでも |
| 入力中の状態が飛ぶ | 作り直した瞬間に、フォーカスもカーソル位置もスクロール位置も消える |
| アニメーションが途切れる | 要素が別物に入れ替わるため |
フレームワークがやっているのは、まさにここです。
書くときは「全部作り直す」ように書ける。 実際に本物のDOMへ当てるのは、変わったところだけ。
この2つを両立させるのがフレームワークの正体です。速くする道具ではありません。 「毎回全部書き直す」という分かりやすい書き方を、現実的なコストで許すための道具です。
② React / Vue / Svelte は何が違うのか
3つとも、上でやりたかったこと(状態を書き換えたら表示が追いつく)を実現します。 違うのは書き方と、「どこが変わったか」をいつ計算するかです。
同じものを3つの書き方で
「押した回数を数えるボタン」を、3つで書くとこうなります。雰囲気を比べるためのものなので、いま全部理解する必要はありません。
React
import { useState } from "react";
function Counter() {
const [count, setCount] = useState(0);
return <button onClick={() => setCount(count + 1)}>{count} 回</button>;
}
Vue
<script setup>
import { ref } from "vue";
const count = ref(0);
</script>
<template>
<button @click="count++">{{ count }} 回</button>
</template>
Svelte
<script>
let count = $state(0);
</script>
<button onclick={() => count++}>{count} 回</button>
やっていることは同じです。 「数を持つ」「押されたら増やす」「その数を表示する」。
違いを表で
| React | Vue | Svelte | |
|---|---|---|---|
| 見た目の書き方 | JSX(JavaScript の中に書く) | テンプレート(HTMLに近い)。1ファイルに script/template/style | HTMLに一番近い。1ファイルに全部 |
| 状態の書き方 | useState で作り、専用の関数で更新 | ref で作り、そのまま代入 | ただの変数のように代入 |
| 更新の計算 | 仮想DOMで、前回の設計図と比較 | 依存を追跡して、変わった部分を更新 | ビルド時に更新コードを生成(実行時の比較が少ない) |
| 状態が変わると | その関数がもう一度呼ばれる | 使っている場所だけが更新される | 使っている場所だけが更新される |
| 書く量 | 多め | 中くらい | 少ない |
| 日本語の情報量 | 一番多い | 多い(日本コミュニティが活発) | 少ない |
| 求人の数 | 一番多い | 多い | 少ない |
ここは誤解しやすいので、はっきり書きます
「仮想DOMがあるから React は速い」は、正確ではありません。 仮想DOMが無いほうが速い場面もあります(Svelte がそちら側です)。 仮想DOMは速さのための仕組みではなく、「毎回全部書き直すように書ける」ようにするための仕組みです。速度は、その書き方を現実的にするための最低条件であって、目的ではありません。
「Svelte が一番新しくて優れている」も違います。 書く量が少ないのは本当です。ただ、詰まったときに出てくる情報の量、使えるライブラリの数、仕事で使われている数は React とは桁が違います。 技術の良し悪しと、学びやすさは別の軸です。
この順路では React を選びます — 理由を正直に
技術的に React が一番優れているから、ではありません。 理由はこの3つです。
- 詰まったときに、日本語の情報が一番多い。 これが独学では決定的です。エラーメッセージをそのまま検索して、日本語の記事が10本出てくるか、英語のGitHub Issueが1本だけかの差は、進む速度を何倍も変えます
- 求人と、他人のコードの量が一番多い。 学んだあとに読むもの・書くものが多い
- Vite が最初から対応している。 前回
npm create vite@latestで選択肢に出ていました。新しい道具を入れずに、前回の続きから始められます
これは「React を勉強すべきだ」という話ではありません。 3つとも解いている問題は同じです。だから1つを本当に理解すれば、残り2つは数日で読めるようになります。 逆に、どれか1つも理解しないまま3つ触ると、どれも分かりません。 最初の1つを、情報が多いもので選ぶ。 それだけの理由です。
Vue や Svelte が向いている場面もあります。既存のページに少しだけ足したいなら Vue は入れやすく、とにかく軽く作りたいなら Svelte が強いです。この順路では扱いませんが、劣っているからではありません。
③ 実際に作る — React のプロジェクト
ここから VMの中の Ubuntu で作業します。VS Code のリモートターミナルでも、SSH でも同じです(VS Code Remote-SSH の回)。
Node.js の確認から。
v22.11.0
10.9.0
バージョンが出れば OK です。出なければ npm の回に戻ってください。
前回の ~/vite-demo/ は消しません
前回作った ~/vite-demo/(Vanilla)はそのまま残してください。 今回は隣に別のディレクトリを作ります。
~/vite-demo/ | ~/react-demo/(今回) | |
|---|---|---|
| 中身 | フレームワークなし | React |
| 役割 | ビルドツールが何をするかを見る | フレームワークが何をするかを見る |
比較対象を消さない、というのは前回と同じ方針です。
npm create vite@latest — 今度は React
対話に答えます。
? Project name: › react-demo
? Select a framework: › React
? Select a variant: › JavaScript
| 質問 | 答え | 理由 |
|---|---|---|
| Project name | react-demo | ディレクトリ名になる |
| Select a framework | React | 前回は Vanilla。ここが今回の差分 |
| Select a variant | JavaScript | TypeScript はまだ扱いません。次の回です |
variant の選択肢に
TypeScriptやJavaScript + SWC、React Router v7などが並びます。 バージョンによって並びが変わります。 カーソルを動かして、JavaScriptとだけ書いてある行を選んでください。+ SWCは変換を担当するツールが違うだけで、書くコードは同じです。どちらでもこの記事は通ります。
[スクリーンショット: 01_create_vite_react.png] npm create vite@latest のフレームワーク選択画面(React にカーソルがある状態)を撮ってください。前回の Vanilla との差分が分かる形で。
確認: ls node_modules | wc -l で数百のディレクトリが出れば成功です。 戻し方: rm -rf node_modules package-lock.json して npm install をやり直せます。
Vanilla と何が違うのか — ファイルを見る
package.json を、前回のものと見比べてください。
{
"name": "react-demo",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"dependencies": {
"react": "^19.0.0",
"react-dom": "^19.0.0"
},
"devDependencies": {
"@vitejs/plugin-react": "^4.3.0",
"vite": "^7.0.0"
}
}
バージョンの数字は違って構いません。 見るのは3箇所です。
| 場所 | 意味 |
|---|---|
dependencies に react / react-dom | devDependencies ではありません。 ビルド後の成果物に中身が入るからです(npm の回の使い分けがここで効きます) |
react と react-dom が別 | React 本体は「見た目を計算する」だけで、ブラウザのDOMに書き込むのは react-dom の仕事。分かれているのは、書き込み先がブラウザとは限らないから |
@vitejs/plugin-react | JSX を JavaScript に変換する担当。 前回の「トランスパイル」がここに来ます |
scripts は前回と同じ3行 | dev / build / preview。 ビルドまわりの操作はまったく変わりません |
index.html も見ます。
<div id="root"></div>
<script type="module" src="/src/main.jsx"></script>
HTMLは、ほぼ空です。 <div id="root"></div> という空の箱が1つあるだけです。
ここが第2段階までと決定的に違うところです。 HTMLの回では、HTMLに中身を書いて、JavaScriptがそれを書き換えていました。 React では、HTMLは空っぽで、中身は全部 JavaScript が作ります。 開発者ツールの Elements タブには要素が並んで見えますが、
index.htmlを開いてもそこには何も書かれていません。 これをクライアントサイドレンダリング(CSR)と呼びます。利点と欠点があります(欠点は後述)。
src/main.jsx を見ます。
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(
<StrictMode>
<App />
</StrictMode>,
)
読み方はこうです。
document.getElementById('root')で空の箱を掴む(ここだけは素のDOM操作です)createRoot(...)で「ここを React に任せる」と宣言する.render(<App />)で中身を渡す
素のDOM操作が出てくるのは、この1箇所だけです。ここから先は、二度と querySelector を書きません。
5173番を開け直す
前回の後片づけで 5173番を閉じました。 もう一度開けます。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5173/tcp の行が出れば準備完了です。開けずに進むと、起動は成功するのにブラウザは読み込み中のまま終わります。
起動する
VITE v7.0.0 ready in 284 ms
➜ Local: http://localhost:5173/
➜ Network: http://192.168.226.50:5173/
--host 0.0.0.0 と、その前の -- は前回と同じ理由で必須です(Linuxのネットワークの回)。付けないと 127.0.0.1 にしか待ち受けず、VMの外からは届きません。
Network の行に出ているIPは、読者ごとに違います。 この記事では 192.168.226.50 で統一していますが、自分の値に読み替えてください。
確認します。VMの中で、
LISTEN 0 511 0.0.0.0:5173 0.0.0.0:* users:(("node",pid=5120,fd=21))
0.0.0.0:5173 なら外向きです。127.0.0.1:5173 なら --host が効いていません。
ホストの Windows のブラウザで http://192.168.226.50:5173/(IPは自分の値に)を開きます。React と Vite のロゴが並んだページと、count is 0 と書かれたボタンが出れば成功です。押すと数字が増えます。
繋がらないときは、内側から1段ずつ。
- VMの中で
curl -I http://localhost:5173/→ 200 が返るか - VMの中で
ss -tlnp | grep 5173→0.0.0.0か127.0.0.1か - ホストで
ping 192.168.226.50(自分のIP)→ ネットワークが繋がっているか - VMの中で
sudo ufw status→ 5173 の行があるか
止め方: ターミナルで Ctrl+C。
[スクリーンショット: 02_react_初期画面.png] 左に VM のターミナル(Local / Network の2行が見えている状態)、右にホストのブラウザで開いた React の初期ページを並べて撮ってください。
④ JSX は HTML ではない
ここが最初にして最大の誤解ポイントです。
src/App.jsx を開くと、JavaScript のファイルの中にHTMLに見えるものが書いてあります。
return (
<div>
<h1>こんにちは</h1>
</div>
);
これは HTML ではありません。 そもそも、JavaScript にこんな文法はありません。 前回のビルドツールの回で「トランスパイル」の例として一瞬出てきたのが、これです。
@vitejs/plugin-react が、だいたいこういう形に変換してからブラウザに渡しています。
return jsx("div", {
children: jsx("h1", { children: "こんにちは" })
});
関数呼び出しです。 つまり JSX は「関数呼び出しの、見やすい書き方」でしかありません。
この一点を掴むと、以下の「変な決まり」が全部説明できます。
class ではなく className
<p className="note">テキスト</p>
class は JavaScript の予約語(クラスを定義するキーワード)です。JSX は JavaScript なので、そのままでは使えません。 だから className です。
同じ理由で <label for="..."> は htmlFor になります。
イベントはキャメルケース、値は関数
<button onClick={handleClick}>押す</button>
HTMLの onclick="..." とは別物です。
| HTML | JSX | |
|---|---|---|
| 書き方 | onclick="doIt()" | onClick={doIt} |
| 中身 | 文字列(ブラウザが後で解釈する) | 関数そのもの |
onClick={doIt()}と書くと、括弧を付けた瞬間に実行されます。 渡したいのは関数であって、関数を実行した結果ではありません。これは初日に必ずやります。 引数を渡したいときはonClick={() => doIt(1)}と、関数で包みます。
{} の中には「式」が書ける。ただし「文」は書けない
<p>{1 + 2}</p> {/* 3 と出る */}
<p>{user.name}</p> {/* 変数 */}
<p>{count > 0 ? "あり" : "なし"}</p> {/* 三項演算子 */}
<p>{items.map((i) => <li key={i.id}>{i.name}</li>)}</p>
書けないのはこちらです。
<p>{ if (count > 0) { "あり" } }</p> {/* 動きません */}
if は「文」であって「値」ではないからです。{} の中に置けるのは値になるもの(式)だけです。だから React では三項演算子 ? : と && を異常によく使います。
{count > 0 && <p>{count} 件あります</p>}
左が偽なら、右は評価されず何も出ません。 JavaScript の基本の回でやった真偽値の話が、ここで表示の制御に化けます。
{count && <p>...</p>}と書くと、countが0のときに画面に「0」と出ます。0は偽ですが、&&は「左の値」をそのまま返すので、0が表示対象になってしまいます。count > 0 &&と、必ず比較の形にしてください。 これは有名な罠です。
return できるのは1つだけ
return (
<h1>タイトル</h1>
<p>本文</p>
);
これは動きません。 return は値を1つしか返せないからです。JSXが関数呼び出しだと分かっていれば当たり前の話です。
囲みます。
return (
<>
<h1>タイトル</h1>
<p>本文</p>
</>
);
<>...</> は「フラグメント」といって、DOMには何も出ない、囲むためだけの箱です。<div> で囲んでもいいのですが、意味のない <div> が増えるとCSSの回でやったレイアウトに影響するので、フラグメントを使います。
その他
| HTML | JSX | 理由 |
|---|---|---|
<br> | <br /> | 閉じないタグが許されない。 必ず自己閉じ |
style="color:red" | style={{ color: "red" }} | オブジェクトを渡す。 外側の {} は「式ですよ」、内側の {} がオブジェクト |
background-color | backgroundColor | JSのプロパティ名にハイフンは使えない |
<!-- コメント --> | {/* コメント */} | JSのコメントを式として置く |
全部「JSXはJavaScriptだから」で説明がつきます。 覚えるものではなく、導けるものです。
⑤ 書き直す — 同じものを React で
①で書いたタスクリストを、React で書きます。 手が痛かったところが、どこに消えるかを見てください。
src/App.jsx を丸ごと置き換えます。
import { useState } from "react";
function App() {
const [tasks, setTasks] = useState([]);
const [text, setText] = useState("");
const add = () => {
if (text === "") return;
setTasks([...tasks, { id: Date.now(), title: text, done: false }]);
setText("");
};
const toggle = (id) => {
setTasks(tasks.map((t) => (t.id === id ? { ...t, done: !t.done } : t)));
};
const remove = (id) => {
setTasks(tasks.filter((t) => t.id !== id));
};
const remaining = tasks.filter((t) => !t.done).length;
return (
<div className="app">
<h1>やること</h1>
<input
type="text"
value={text}
placeholder="何か入力"
onChange={(e) => setText(e.target.value)}
/>
<button onClick={add}>追加</button>
<p>残り {remaining} 件 / 全 {tasks.length} 件</p>
<ul>
{tasks.map((task) => (
<li key={task.id}>
<span
onClick={() => toggle(task.id)}
className={task.done ? "done" : ""}
>
{task.title}
</span>
<button onClick={() => remove(task.id)}>削除</button>
</li>
))}
</ul>
</div>
);
}
export default App;
src/index.css も丸ごと置き換えます(テンプレートの初期CSSは画面を中央寄せするので、見づらくなります)。
body {
font-family: sans-serif;
margin: 2rem;
line-height: 1.7;
}
.done {
text-decoration: line-through;
color: #888;
}
li span {
cursor: pointer;
}
保存すると、ブラウザが勝手に切り替わります(前回やった HMR です)。
確認: 入力して「追加」、文字をクリックで取り消し線、「削除」で消える、そして件数が常に合っている。 戻し方: git を使っていないので、やり直したいときは rm -rf ~/react-demo してもう一度 npm create vite@latest です。
[スクリーンショット: 03_タスクリスト.png] タスクを3つ追加し、1つを完了(取り消し線)にした状態を撮ってください。「残り 2 件 / 全 3 件」の表示が見える形で。
何が消えたのか — 並べて見る
| ①で手で書いていたこと | React では |
|---|---|
document.querySelector("#list") で掴む | 掴まない。 return した見た目そのものが対象 |
document.createElement("li") | tasks.map() の中に <li> と書く |
li.appendChild(span) | 入れ子にして書くだけ |
li.remove() | 書かない。 配列から filter で消せば、表示も消える |
counter.textContent = ... を3箇所 | remaining を1回計算するだけ({remaining} の1箇所) |
span.style.textDecoration = ... | className={task.done ? "done" : ""}。 状態から見た目が決まる |
| 配列とDOMを一致させ続ける責任 | 無い。 配列が変われば表示が追いつく |
消えたのは「反映する手順」です。 残ったのは「どういうデータなら、どういう見た目になるか」だけ。
これが「宣言的」という言葉の中身です。 命令的(①): 「
liを作れ。spanを作れ。文字を入れろ。くっつけろ。件数を書き換えろ」 宣言的(React): 「タスクが3件あるなら、liは3つで、件数はこう」手順を書かず、対応関係だけを書く。 そして手順のほうをフレームワークが計算する。それだけの話です。
key は飾りではない
{tasks.map((task) => (
<li key={task.id}>
key を付けないと、開発者ツールの Console に警告が出ます。
Warning: Each child in a list should have a unique "key" prop.
これは無視してはいけない警告です。
React は「前回の設計図」と「今回の設計図」を比べて差分を出します。そのとき「前回の3番目」と「今回の3番目」が同じものかどうかを判断する必要があります。key はその判断に使う目印です。
key={index}(配列の順番)を使ってはいけません。 先頭に1件追加した瞬間、全部の index が1つずれます。React から見ると「全部が別物に入れ替わった」ように見えます。 結果として、入力途中の文字が別の行に移る、チェックの位置がずれるといった、原因が非常に分かりにくいバグになります。keyには、そのデータ自身が持つ変わらないID(ここではtask.id)を使ってください。
Date.now() をIDにしているのは、この記事の範囲では十分だからです。同じミリ秒に2件追加すると衝突しますが、手で押している限り起きません。 本番ならデータベースの回でやった採番か、crypto.randomUUID() を使います。
なぜ tasks.push() ではなく setTasks([...tasks, ...]) なのか
これが React で2番目につまずくところです。
// 動きません
tasks.push(newTask);
エラーは出ません。配列にも入ります。それなのに画面が変わりません。
理由: React は「状態が変わった」ことを、setTasks が呼ばれたかどうかで知ります。 配列を直接いじっても、React には何も伝わりません。
さらに、setTasks(tasks) と同じ配列を渡しても駄目です。React は中身を1つずつ比べるのではなく、「別のものになったか」を見るからです。同じ配列を渡せば「変わっていない」と判断されます。
だから新しい配列を作って渡します。
| やりたいこと | 書き方 |
|---|---|
| 末尾に足す | setTasks([...tasks, newTask]) |
| 消す | setTasks(tasks.filter((t) => t.id !== id)) |
| 1件だけ書き換える | setTasks(tasks.map((t) => t.id === id ? { ...t, done: !t.done } : t)) |
... はスプレッド構文で、「中身を展開して、新しい入れ物に移す」という書き方です。元は変えません。
{ ...t, done: !t.done }の読み方。 「tの中身を全部コピーして、そのうちdoneだけ入れ替えた新しいオブジェクト」です。 元のtは無傷です。だから React から見て「別のものになった」と分かります。
「差分だけ当てている」ことを目で見る
開発者ツールの回でやった Elements タブを開いてください。
- F12 → Elements タブ
<div id="root">を展開して、<ul>の中が見える状態にする- ブラウザ側でタスクを1件追加する
追加された <li> だけが一瞬ハイライトされ、既にあった <li> は光りません。
「全部書き直すように書いた」のに、「変わったところだけが本物のDOMに当たっている」。 これが仮想DOMの働きです。
[スクリーンショット: 04_elements_差分.png] Elements タブで <ul> の中を開いた状態で、新しく追加された <li> だけがハイライトされている瞬間を撮ってください。
⑥ この段階で入れてはいけないもの
検索すると、必ずこれらが出てきます。全部、いまは入れません。
| 入れたくなるもの | 何をするもの | いま入れない理由 |
|---|---|---|
| Redux / Zustand | 状態管理ライブラリ | useState で困っていないから。 困っていない問題の解決策を入れると、何が React で何がライブラリか分からなくなる |
| MUI / Chakra UI | 見た目の部品集 | ボタンが最初から綺麗になる代わりに、CSSを書かなくなる。 自分で書けないものは直せない |
| React Router | URLごとに画面を変える | 画面が1枚しかないから。 次の回で扱う |
| Next.js | React を含む上位のフレームワーク | 層が違う。 React 自体が分かる前に入れると、どちらの機能か切り分けられない |
| TypeScript | 型を付ける | 次の回で単独でやる。 一度に2つ新しいものを入れない |
前回、Vite で
Vanillaを選んだのとまったく同じ理由です。 一度に1つしか新しいものを入れない。 2つ入れると、動かなかったときにどちらが原因か分かりません。 そして初学者の時期は、必ず動かなくなります。
「じゃあ、いつ入れるのか」への答えは1つです。
自分が困ってから。 「状態を渡すのが辛くなった」と自分の手で感じてから Zustand を見る。そのとき初めて、そのライブラリが何を解いているかが分かります。 困る前に入れると、便利さも分かりません。
⑦ ビルドしてみる — 前回の続きが効く
フレームワークを入れても、ビルドまわりは何も変わりません。
dist/ の中身は前回とほぼ同じ形です。index.html と、ハッシュ付きの .js / .css。
違うのはサイズです。
React 本体(react と react-dom)が中に入るので、Vanilla のときより大きくなります。 これが「dependencies に入っている」ということの意味です。
ここは正直に書きます。 フレームワークはタダではありません。 何もしないページでも、React の本体を読者に配ることになります。 「ボタン1個のページ」に React を入れるのは割に合いません。 素のJSで十分です。 元が取れるのは、状態と表示のずれが本当に苦しくなってからです。①の痛みを先に味わってもらったのは、そのためです。
つまずいたところ
ボタンを押しても何も起きない。エラーも出ない → tasks.push() のように、状態を直接いじっています。 setTasks(...) で新しい配列を渡してください。
onClick={add()} にしたら、ページを開いた瞬間に動いた → 括弧を付けると、その場で実行されます。 onClick={add} か onClick={() => add(1)} です。
class="note" と書いたら警告が出た → className です。 class は JavaScript の予約語です。
return に2つ並べたら「Adjacent JSX elements must be wrapped」 → <>...</> で囲んでください。 return は1つしか返せません。
件数が 0 のとき、画面に「0」と出る → {count && ...} を書いています。 {count > 0 && ...} にしてください。
Console の console.log が2回出る → main.jsx の <StrictMode> が、開発中だけわざと2回呼んでいます。 不具合ではありません。「同じ処理を2回やっても壊れないか」を検査するためです。本番ビルドでは1回です。
入力欄に文字が打てない → value={text} を書いて onChange を書いていません。 React では入力欄の中身も状態なので、状態が変わらない=表示も変わらないになります。
保存しても画面が変わらない → npm run dev が動いているか確認してください。ファイルをVMの外(Windows側)で編集していないかも確認を(VS Code Remote-SSHで繋いでいれば、編集先はVMの中です)。
ホストのブラウザから繋がらない → --host 0.0.0.0 の付け忘れか、sudo ufw allow 5173/tcp の忘れです。前回と同じ2つです。
npm run dev が「vite: not found」 → npm install を打っていないか、cd react-demo を忘れています。 pwd で確認してください。
後片づけ
開けたポートを閉じます。
①で 8000番を開け直したなら、それも閉じます。
~/react-demo/ は、次の回でも使うので残してください。
全部やり直したいときは:
~/vite-demo/(Vanilla)と ~/web/(素のHTML)も、まだ消さないでください。 比較対象として何度も出てきます。
まとめ
- フレームワークが解いている問題は「描画」ではなく、「同じ情報が配列とDOMの2箇所にあって、一致させ続ける責任が全部自分にある」こと
- その苦しさは、機能が増えるたびに掛け算で増える。 件数の更新を3箇所に書いた時点で、もう始まっている
- 解き方は「毎回、全部作り直す」。 ただし素のDOMでやると重く、フォーカスもスクロールも飛ぶ
- フレームワークは「全部作り直すように書けて、実際に当てるのは差分だけ」を両立させる道具。 速くする道具ではない
- React・Vue・Svelte は同じ問題を解いている。 違うのは書き方と、差分をいつ計算するか(実行時に比較 / 依存を追跡 / ビルド時に生成)
- 仮想DOMは速さのための仕組みではない。 「毎回書き直す書き方」を現実的にするための最低条件
- この順路で React を選ぶのは、技術的に優れているからではない。 日本語の情報量・他人のコードの量・Vite が最初から対応しているという3点
- 1つを本当に理解すれば、残り2つは読める。 どれも理解しないまま3つ触ると、どれも分からない
- JSX は HTML ではない。 関数呼び出しの見やすい書き方であって、JavaScript そのもの
className・{}に式しか書けない・returnは1つ。全部「JSXはJavaScriptだから」で導けるonClick={doIt()}は、括弧を付けた瞬間に実行される。 渡すのは関数であって、実行結果ではない- 状態は直接いじらず、必ず新しいものを作って
set...に渡す。 React は「別のものになったか」で変化を判断する keyに index を使わない。 先頭に1件足しただけで全部ずれ、原因の分かりにくいバグになる{count && ...}は0を画面に出す。 必ずcount > 0 &&の形にする- 状態管理ライブラリもUIライブラリも、この段階では入れない。 困ってから入れる。困る前に入れると、便利さすら分からない
- フレームワークはタダではない。 React 本体が成果物に入る。ボタン1個のページには割に合わない
querySelectorを書くのはmain.jsxの1箇所だけになる。 それ以降は、データと見た目の対応関係だけを書く
参考リンク
- roadmap.sh — Frontend(Pick a Framework の項目)
- roadmap.sh — React
- React 公式(日本語)
- React — UI を記述する
- React — state: コンポーネントのメモリ
- Vue.js 公式(日本語)
- Svelte 公式
- Vite — 公式ガイド(日本語)
次に読む
この記事は 【第4段階】フロントエンド の 1 / 15 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- React
- Vue.js
- Svelte
- Writing Components
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント