手でDOMを書き換えるのをやめる — React・Vue・Svelte

React・Vue・Svelte。状態のカードと組み立てられた画面の部品、ノートパソコン。

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ライブラリを入れてはいけない理由

この記事でやること

  1. DOM操作の回のコードに「削除」と「件数」を足して、何が苦しくなるかを自分の手で確かめる
  2. React / Vue / Svelte の違いを並べて見て、この順路で React を選ぶ理由を確認する
  3. VMの中で npm create vite@latest を実行し、今度は React でプロジェクトを作る(前回の Vanilla との差分を見る)
  4. sudo ufw allow 5173/tcp でポートを開け直し、npm run dev -- --host 0.0.0.0 でホストのブラウザから開く
  5. 手順1と同じものを React で書き直し、2つのコードを並べて「何が消えたか」を見る

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
状態(state)画面を組み立てるのに必要なデータ。「タスクの配列」「入力欄の中身」など
宣言的(declarative)「こういう見た目にしたい」だけを書くやり方。「どう書き換えるか」は書かない
命令的(imperative)「これをこう書き換えろ」と手順を書くやり方。textContent = ... はこちら
コンポーネント見た目と、その見た目が使う状態を、ひとまとまりにした部品。関数1つで書く
再レンダリング状態が変わったときに、その部品の見た目をもう一度計算し直すこと
仮想DOM本物のDOMではなく、JavaScriptのオブジェクトで作った「見た目の設計図」。前と比べて差分だけ本物に反映する
JSXJavaScript の中に、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>

やっていることは同じです。 「数を持つ」「押されたら増やす」「その数を表示する」。

違いを表で

ReactVueSvelte
見た目の書き方JSX(JavaScript の中に書く)テンプレート(HTMLに近い)。1ファイルに script/template/styleHTMLに一番近い。1ファイルに全部
状態の書き方useState で作り、専用の関数で更新ref で作り、そのまま代入ただの変数のように代入
更新の計算仮想DOMで、前回の設計図と比較依存を追跡して、変わった部分を更新ビルド時に更新コードを生成(実行時の比較が少ない)
状態が変わるとその関数がもう一度呼ばれる使っている場所だけが更新される使っている場所だけが更新される
書く量多め中くらい少ない
日本語の情報量一番多い多い(日本コミュニティが活発)少ない
求人の数一番多い多い少ない

ここは誤解しやすいので、はっきり書きます

「仮想DOMがあるから React は速い」は、正確ではありません。 仮想DOMが無いほうが速い場面もあります(Svelte がそちら側です)。 仮想DOMは速さのための仕組みではなく、「毎回全部書き直すように書ける」ようにするための仕組みです。速度は、その書き方を現実的にするための最低条件であって、目的ではありません。

「Svelte が一番新しくて優れている」も違います。 書く量が少ないのは本当です。ただ、詰まったときに出てくる情報の量、使えるライブラリの数、仕事で使われている数は React とは桁が違います。 技術の良し悪しと、学びやすさは別の軸です。

この順路では React を選びます — 理由を正直に

技術的に React が一番優れているから、ではありません。 理由はこの3つです。

  1. 詰まったときに、日本語の情報が一番多い。 これが独学では決定的です。エラーメッセージをそのまま検索して、日本語の記事が10本出てくるか、英語のGitHub Issueが1本だけかの差は、進む速度を何倍も変えます
  2. 求人と、他人のコードの量が一番多い。 学んだあとに読むもの・書くものが多い
  3. 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 の確認から。

bash
$ node -v
$ npm -v
v22.11.0
10.9.0

バージョンが出れば OK です。出なければ npm の回に戻ってください。

前回の ~/vite-demo/ は消しません

前回作った ~/vite-demo/(Vanilla)はそのまま残してください。 今回は隣に別のディレクトリを作ります。

~/vite-demo/~/react-demo/(今回)
中身フレームワークなしReact
役割ビルドツールが何をするかを見るフレームワークが何をするかを見る

比較対象を消さない、というのは前回と同じ方針です。

npm create vite@latest — 今度は React

bash
$ cd ~
$ npm create vite@latest

対話に答えます。

? Project name: › react-demo
? Select a framework: › React
? Select a variant: › JavaScript
質問答え理由
Project namereact-demoディレクトリ名になる
Select a frameworkReact前回は Vanilla。ここが今回の差分
Select a variantJavaScriptTypeScript はまだ扱いません。次の回です

variant の選択肢に TypeScript や JavaScript + SWC、React Router v7 などが並びます。 バージョンによって並びが変わります。 カーソルを動かして、JavaScript とだけ書いてある行を選んでください。 + SWC は変換を担当するツールが違うだけで、書くコードは同じです。どちらでもこの記事は通ります。

[スクリーンショット: 01_create_vite_react.png] npm create vite@latest のフレームワーク選択画面(React にカーソルがある状態)を撮ってください。前回の Vanilla との差分が分かる形で。

bash
$ cd react-demo
$ npm install

確認: ls node_modules | wc -l で数百のディレクトリが出れば成功です。 戻し方: rm -rf node_modules package-lock.json して npm install をやり直せます。

Vanilla と何が違うのか — ファイルを見る

bash
$ ls -R src
$ cat package.json

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-domdevDependencies ではありません。 ビルド後の成果物に中身が入るからです(npm の回の使い分けがここで効きます)
react と react-dom が別React 本体は「見た目を計算する」だけで、ブラウザのDOMに書き込むのは react-dom の仕事。分かれているのは、書き込み先がブラウザとは限らないから
@vitejs/plugin-reactJSX を JavaScript に変換する担当。 前回の「トランスパイル」がここに来ます
scripts は前回と同じ3行dev / build / preview。 ビルドまわりの操作はまったく変わりません

index.html も見ます。

bash
$ cat 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 を見ます。

bash
$ cat 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>,
)

読み方はこうです。

  1. document.getElementById('root') で空の箱を掴む(ここだけは素のDOM操作です)
  2. createRoot(...) で「ここを React に任せる」と宣言する
  3. .render(<App />) で中身を渡す

素のDOM操作が出てくるのは、この1箇所だけです。ここから先は、二度と querySelector を書きません。

5173番を開け直す

前回の後片づけで 5173番を閉じました。 もう一度開けます。

bash
$ sudo ufw allow 5173/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere

5173/tcp の行が出れば準備完了です。開けずに進むと、起動は成功するのにブラウザは読み込み中のまま終わります。

起動する

bash
$ npm run dev -- --host 0.0.0.0
  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の中で、

bash
$ ss -tlnp | grep 5173
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段ずつ。

  1. VMの中で curl -I http://localhost:5173/ → 200 が返るか
  2. VMの中で ss -tlnp | grep 5173 → 0.0.0.0 か 127.0.0.1 か
  3. ホストで ping 192.168.226.50(自分のIP)→ ネットワークが繋がっているか
  4. 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="..." とは別物です。

HTMLJSX
書き方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の回でやったレイアウトに影響するので、フラグメントを使います。

その他

HTMLJSX理由
<br><br />閉じないタグが許されない。 必ず自己閉じ
style="color:red"style={{ color: "red" }}オブジェクトを渡す。 外側の {} は「式ですよ」、内側の {} がオブジェクト
background-colorbackgroundColorJSのプロパティ名にハイフンは使えない
<!-- コメント -->{/* コメント */}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 タブを開いてください。

  1. F12 → Elements タブ
  2. <div id="root"> を展開して、<ul> の中が見える状態にする
  3. ブラウザ側でタスクを1件追加する

追加された <li> だけが一瞬ハイライトされ、既にあった <li> は光りません。

「全部書き直すように書いた」のに、「変わったところだけが本物のDOMに当たっている」。 これが仮想DOMの働きです。

[スクリーンショット: 04_elements_差分.png] Elements タブで <ul> の中を開いた状態で、新しく追加された <li> だけがハイライトされている瞬間を撮ってください。


⑥ この段階で入れてはいけないもの

検索すると、必ずこれらが出てきます。全部、いまは入れません。

入れたくなるもの何をするものいま入れない理由
Redux / Zustand状態管理ライブラリuseState で困っていないから。 困っていない問題の解決策を入れると、何が React で何がライブラリか分からなくなる
MUI / Chakra UI見た目の部品集ボタンが最初から綺麗になる代わりに、CSSを書かなくなる。 自分で書けないものは直せない
React RouterURLごとに画面を変える画面が1枚しかないから。 次の回で扱う
Next.jsReact を含む上位のフレームワーク層が違う。 React 自体が分かる前に入れると、どちらの機能か切り分けられない
TypeScript型を付ける次の回で単独でやる。 一度に2つ新しいものを入れない

前回、Vite で Vanilla を選んだのとまったく同じ理由です。 一度に1つしか新しいものを入れない。 2つ入れると、動かなかったときにどちらが原因か分かりません。 そして初学者の時期は、必ず動かなくなります。

「じゃあ、いつ入れるのか」への答えは1つです。

自分が困ってから。 「状態を渡すのが辛くなった」と自分の手で感じてから Zustand を見る。そのとき初めて、そのライブラリが何を解いているかが分かります。 困る前に入れると、便利さも分かりません。


⑦ ビルドしてみる — 前回の続きが効く

フレームワークを入れても、ビルドまわりは何も変わりません。

bash
$ npm run build
$ ls -la dist dist/assets

dist/ の中身は前回とほぼ同じ形です。index.html と、ハッシュ付きの .js / .css。

違うのはサイズです。

bash
$ du -sh dist

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 で確認してください。


後片づけ

開けたポートを閉じます。

bash
$ sudo ufw delete allow 5173/tcp
$ sudo ufw status

①で 8000番を開け直したなら、それも閉じます。

bash
$ sudo ufw delete allow 8000/tcp

~/react-demo/ は、次の回でも使うので残してください。

全部やり直したいときは:

bash
$ rm -rf ~/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箇所だけになる。 それ以降は、データと見た目の対応関係だけを書く

参考リンク


次に読む

この記事は 【第4段階】フロントエンド の 1 / 15 本目です。

記事
← 前の記事dist/ の中身は何なのか — ビルドツールとVite
→ 次の記事コンポーネントは見た目の部品ではない — propsと状態

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›Pick a Framework
  • React
  • Vue.js
  • Svelte
  • Writing Components

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次