全消し再描画から卒業する — Reactの到達作品

Reactの到達作品。タスク一覧の画面とコンポーネントを表すブロック。

※本記事はアフィリエイト広告(PR)を含みます。

素のJavaScriptで作ったやることリストを、Reactで書き直す演習です。全消しして描き直すのをやめ、状態の変更だけで画面が追いつく形にします。

前回: divのボタンはキーボードで押せない — アクセシビリティ

これは React コースの「到達作品」の回です。 Frontendの到達作品(素のJS版)の続きです。あちらで素の JavaScript だけで作った「やることリスト」を、ここでは React で書き直します。 1から新しいアプリを作るのではありません。同じものが、React でどう変わるかを見る回です。到達作品を本物のアプリへ育てる話は 「動く」と「使える」の差は4つの状態 に続きます。

この記事は手元のPCで作れます(VMでも可)。Node.js が要ります。 素のJS版はテキストエディタとブラウザだけで作れましたが、今回はビルドが要るので Node.js が必要です。なぜビルドが要るのかは①で、素のJS版と対比して説明します。


対象レベル: 初級 / 区分: 必修

目次

めがける作品

素のJS版で作った「やることリスト」を、React + Vite で書き直します。

作るものは、見た目としてはほとんど同じです。

  • 入力して追加できる
  • チェックで完了/未完了を切り替えられる
  • 削除できる
  • 残り何件かが常に正しく出る
  • 1件も無いときは「まだありません」と出る

ここまでは、素のJS版とまったく同じです。同じものを React で書くと、何が消えて、何が楽になるのか。 それがこの記事の前半(①〜③)です。

そして後半では、素のJS版では「つらい」で終わっていた2つを足します。

  • 画面を増やす(一覧 / と 詳細 /todos/:id の2画面)。 素のJS版では複数画面を作るのがつらすぎて、1画面で止めました
  • APIからデータを取得する。 素のJS版は localStorage に保存するだけで、外からデータを取れませんでした

完成すると、こう動きます。

┌───────────────────────────────┐
│  やることリスト        残り 2件 │   ← 一覧 /
│  ┌─────────────────────┐ +   │
│  │ 牛乳を買う           │      │
│  └─────────────────────┘      │
│  ☐ 牛乳を買う      詳細 ✕      │──┐
│  ☑ 資料を送る      詳細 ✕      │  │ 「詳細」を押すと
│  ☐ 部屋を片づける  詳細 ✕      │  │ /todos/3 へ移動
└───────────────────────────────┘  │
┌───────────────────────────────┐  │
│  ← 一覧へ戻る                  │◀─┘
│  未完了                        │   ← 詳細 /todos/:id
│  部屋を片づける                 │
└───────────────────────────────┘

新しいアプリを1から作る回ではありません。 前に手で書いたものが、React という道具でどう変わるかを見ます。あなたはもう「状態から画面を作る」考え方を、素のJSで手書きできます。 だから React の説明が、これから全部つながります。

この記事でわかること

  • 素のJS版の render()(全消しして作り直す)は、React では書かなくてよくなること。useState を使うと、変わったところだけReact が書き換えてくれること
  • その結果、入力欄のカーソルが飛ばなくなること。全消し再描画がなぜカーソルを飛ばしていたのか
  • なぜ React には「ビルド」が要るのか。素のJS版は3ファイルをそのまま開けたのに、React はそうできない理由
  • 状態を「直接書き換えてはいけない」こと。素のJSの todos.push(...) が、React では setTodos([...todos, ...]) に変わる理由
  • 素のJSでつらかった「複数画面」と「データ取得」が、React だと道具で解けること。ただし本番で直リンクが404になるという新しい罠も出ること

この記事でやること

  1. Vite で React プロジェクトを作る。素のJS版の3ファイルと何が違うかを対比する
  2. 素のJS版のやることリストを、useState + map で書き直す(山場)
  3. コンポーネント(TodoList / TodoItem / AddForm)に分け、props で渡す
  4. 画面を2つにする(一覧 / と 詳細 /todos/:id)。React Router で繋ぐ
  5. APIからデータを取得し、読み込み中・エラー・空・正常の4状態を出す
  6. npm run build して dist/ を作り、静的ホスティングに公開する(または npm run preview で見る)
  7. 完成の判定(6つのチェック)を自分で通す

先に知る言葉

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

言葉意味
コンポーネント画面の部品。状態と見た目をまとめた、呼び出せる関数。<TodoItem /> のように使う
props親から子のコンポーネントへ渡す値。子は受け取るだけで、勝手に書き換えない
状態(state)コンポーネントが覚えておく値。React では useState で持つ
再描画(レンダリング)状態が変わったときに、React が画面を作り直すこと。素のJSと違い差分だけ当ててくれる
key一覧の各項目に付ける変わらない目印。React が「どれがどれか」を見分けるのに使う
ルーティングURL(/ や /todos/3)に応じて、出す画面を切り替えること。ここでは React Router を使う
useEffect描画とは別に、外の世界と関わる(例: APIを叩く)ための仕組み
ビルドJSX や複数ファイルを、ブラウザがそのまま読める形(dist/)に変換すること。Vite がやる

① Vite で作る — 素のJS版と、まず対比する

コードを書く前に、素のJS版と何が違うかをはっきりさせます。 ここを飛ばすと「React はなぜこんなに手数が多いのか」が腑に落ちません。

素のJS版React版(今回)
ファイルindex.html / style.css / app.js の3つを手書きVite がプロジェクト一式を生成する
開き方ダブルクリックで開くだけビルドか開発サーバーが要る。直接開いても動かない
画面の更新render() を自分で呼ぶ状態を変えるとReact が勝手に描き直す
必要なものテキストエディタとブラウザNode.js も要る

なぜ、ダブルクリックで開けないのか

素のJS版の app.js は、ブラウザがそのまま読める JavaScript でした。だから index.html をダブルクリックすれば動きました。

React では、こう書きます。

<span className="text">{todo.text}</span>

この <span> を JavaScript の中に直接書く書き方(JSX)を、ブラウザは理解できません。 これは JavaScript の正式な文法ではないからです。ブラウザに渡す前に、素の JavaScript へ変換(=ビルド)する必要があります。それをやるのが Vite です。

「便利になったのに、手数が増えた」のは矛盾ではありません。 素のJSは「ブラウザが読める形」を人間が直接書いていました。React は「人間が読みやすい形」で書いて、機械が「ブラウザが読める形」に翻訳します。 その翻訳の一手間が、ビルドです。ビルドツールが dist/ に何を吐くのかは、⑥で実際に中を開いて確かめます。

作る

手元のPC(Windows本体でも、VMの中でも可)で打ちます。 Node.js が入っていることは node -v で確認できます。数字が返れば入っています。

bash
$ npm create vite@latest todo-react -- --template react
$ cd todo-react
$ npm install

-- の後ろは npm create ではなく、その先の道具(create-vite)へ渡る引数です。--template react で「React のひな形」を選んでいます。

npm install は、package.json に書かれた部品を node_modules/ に落としてくる作業です。素のJS版には無かった工程です。生成されたフォルダの中を見てください。

bash
$ ls todo-react
index.html  package.json  node_modules  public  src  vite.config.js

素のJS版の3ファイルと、対応させて見ます。

素のJS版React版(Vite)役割
index.htmlindex.html(中身はほぼ空)入口。ただし中身は <div id="root"> だけ。中身は JavaScript が作る
app.jssrc/main.jsx → src/App.jsxアプリ本体。画面も JavaScript の中に書く(JSX)
style.csssrc/App.css見た目
(無い)package.json / node_modules/使う部品の一覧と、その実体
(無い)vite.config.jsビルドと開発サーバーの設定

一番の違いは index.html です。 素のJS版は HTML に直接 <ul> や <form> を書きました。Vite の index.html は、ほぼ <div id="root"></div> の1行だけです。画面は全部 JavaScript(src/)が作って、その root に流し込みます。 だから、HTML をダブルクリックしても空っぽで、開発サーバーかビルドが要るのです。

続けて、開発サーバーを立ち上げます。

bash
$ npm run dev

ターミナルに http://localhost:5173/ のようなURLが出ます。ブラウザで開いて、Vite の初期画面(ロゴとカウントボタン)が出れば成功です。

確認: この画面のカウントボタンを何度か押してみてください。数字が増えます。 これがもう useState です。素のJSなら addEventListener と textContent を書くところが、ひな形の中に既に入っています。次で、この中身を丸ごと書き換えます。

戻し方: ここまでで失敗したら、todo-react/ フォルダを丸ごと消してやり直せます。手元に他のものは何も作っていません。


② 状態を変えるだけで、画面が追いつく

ここがこの記事のいちばん大事なところです。 素のJS版の render() を思い出してください。

// 素のJS版。状態が変わるたびに、これを自分で呼んでいた。
function render() {
  list.innerHTML = "";           // ⚠️ いったん全部消して
  for (const todo of todos) {    // ⚠️ 全部作り直す
    const li = document.createElement("li");
    // ...省略...
    list.append(li);
  }
}

「全部消して、全部作り直す」——これが素のJS版の心臓であり、最後に残ったつらさでした。 3件なら一瞬ですが、数百件だと毎回全消し・全再構築は無駄で、入力欄のカーソルまで飛びます(作り直したDOMは別物なので、フォーカスが外れる)。

React では、この render() を書きません。 代わりに、こう考えます。

状態(useState)を変えるだけ。画面をどう書き換えるかは、React が引き受ける。

src/App.jsx を、丸ごと次の内容に置き換えます。

import { useState } from 'react'
import './App.css'

export default function App() {
  const [todos, setTodos] = useState([])
  const [text, setText] = useState('')

  function add(e) {
    e.preventDefault()                 // ⚠️ 素のJSと同じ。送信でページが再読み込みされるのを止める
    const value = text.trim()
    if (value === '') return
    setTodos([...todos, { id: Date.now(), text: value, done: false }])
    setText('')
  }

  function toggle(id) {
    setTodos(todos.map((t) => (t.id === id ? { ...t, done: !t.done } : t)))
  }

  function remove(id) {
    setTodos(todos.filter((t) => t.id !== id))
  }

  const remaining = todos.filter((t) => !t.done).length

  return (
    <main className="app">
      <header className="head">
        <h1>やることリスト</h1>
        <span className="count">残り {remaining}件</span>
      </header>

      <form className="form" onSubmit={add}>
        <input
          className="input"
          value={text}
          onChange={(e) => setText(e.target.value)}
          placeholder="やることを入力"
        />
        <button className="add" type="submit">+</button>
      </form>

      {todos.length === 0 ? (
        <p className="empty">まだ何もありません。上の欄から追加してください。</p>
      ) : (
        <ul className="list">
          {todos.map((todo) => (
            <li key={todo.id} className={'item' + (todo.done ? ' done' : '')}>
              <input
                type="checkbox"
                checked={todo.done}
                onChange={() => toggle(todo.id)}
              />
              <span className="text">{todo.text}</span>
              <button className="del" onClick={() => remove(todo.id)}>✕</button>
            </li>
          ))}
        </ul>
      )}
    </main>
  )
}

素のJS版と、1行ずつ見比べてください。 骨組みは驚くほど同じです。

素のJS版React版
let todos = []const [todos, setTodos] = useState([])
todos.push(...); render()setTodos([...todos, ...])
todo.done = !todo.done; render()setTodos(todos.map(...))
todos = todos.filter(...); render()setTodos(todos.filter(...))
render() を自分で呼ぶ呼ばない。setTodos が呼ぶと React が描き直す

render() という行が、React版には1つもありません。 状態を変えると、React が「前の画面」と「新しい画面」を見比べて、変わったところだけDOMに当てます。これが コンポーネントは見た目の部品ではない — propsと状態 でやった「状態から画面を作る」の自動版です。

なぜ todos.push ではなく setTodos([...todos, ...]) なのか

ここが素のJSから来た人が必ず引っかかる所です。

// ❌ これは動かない(画面が変わらない)
todos.push({ id: Date.now(), text: value, done: false })

// ⭕ これが正しい
setTodos([...todos, { id: Date.now(), text: value, done: false }])

todos.push() は、配列を直接書き換えます。 すると React は「配列は同じものだ」と判断して、描き直しません。 React は「setTodos が呼ばれたか」で描き直すかを決めるので、新しい配列を作って setTodos に渡す必要があります。[...todos, x](追加)、.map(変更)、.filter(削除)は、どれも元を壊さず新しい配列を作る書き方です。

素のJSでは「状態を変えて render() を呼ぶ」の2手でした。 React は「setState で新しい状態を渡す」の1手ですが、その代わり「元を書き換えない」という約束が要ります。この約束を守っている限り、React は「前の状態」と「今の状態」を安全に見比べられます。

入力欄は「状態が本体、画面は写し」

入力欄も、素のJS版とは考え方が変わっています。

const [text, setText] = useState('')
// ...
<input value={text} onChange={(e) => setText(e.target.value)} />

素のJS版では、input.value そのものが「いま何が打たれているか」でした。画面が本体だったのです。React では逆で、text(状態)が本体で、<input> の見た目は value={text} で写しているだけです。

この書き方には、名前が付いています。「制御されたコンポーネント(controlled component)」です。

  • 打つと onChange が走り、setText で状態が変わる
  • 状態が変わると再描画され、value={text} で入力欄に反映される

value だけ書いて onChange を書かないと、入力欄に文字を打っても何も出ません。 「本体」である text が変わらないので、写しである <input> も変わらないからです。React を始めた人が最初に「キーボードが効かない」と驚くのは、たいていこれです。片方だけでは動かず、value と onChange は必ずセットです。

key を付ける理由

一覧の各項目に key={todo.id} を付けています。付けないと、React が黄色い警告を出します。

key は「どの項目がどれか」を React に教える目印です。 これが無いと、削除や並べ替えのときに React が項目を取り違え、チェックの状態が別の行に付くといった事故が起きます。

key に「配列の何番目か(添字)」を使ってはいけません。 削除で番号がずれると、別物を同じ key と見なしてしまうからです。素のJS版で「削除は添字でなく id で」とやったのと、まったく同じ理由です。詳しくは keyに添字を使うとズレる — React深掘り にあります。

見た目を当てる

src/App.css を丸ごと置き換えます。素のJS版の style.css を、クラス名だけ合わせてほぼそのまま持ってきたものです。

:root { --line: #d9d4c5; --ink: #14181f; --accent: #2f6f4f; }
* { box-sizing: border-box; }
body {
  margin: 0; padding: 24px 12px;
  background: #fffdf3; color: var(--ink);
  font-family: system-ui, sans-serif;
}
.app { max-width: 480px; margin: 0 auto; }
.head { display: flex; align-items: baseline; justify-content: space-between; gap: 12px; }
.head h1 { font-size: 20px; margin: 0; }
.count { font-size: 14px; color: #555; white-space: nowrap; }

.form { display: flex; gap: 8px; margin: 16px 0; }
.input {
  flex: 1; min-width: 0; padding: 10px 12px;
  border: 2px solid var(--ink); border-radius: 8px; font-size: 16px;
}
.add {
  border: 2px solid var(--ink); border-radius: 8px; background: var(--accent);
  color: #fff; font-size: 18px; padding: 0 16px; cursor: pointer;
}

.list { list-style: none; margin: 0; padding: 0; }
.item {
  display: flex; align-items: center; gap: 10px;
  padding: 10px 4px; border-bottom: 1px solid var(--line);
}
.item .text { flex: 1; min-width: 0; word-break: break-word; }
.item.done .text { text-decoration: line-through; color: #999; }
.item a { font-size: 13px; color: var(--accent); text-decoration: none; white-space: nowrap; }
.del { border: none; background: none; color: #b23; font-size: 16px; cursor: pointer; }
.empty { color: #888; text-align: center; padding: 24px 0; }
.detail { max-width: 480px; margin: 0 auto; }
.state { color: #888; text-align: center; padding: 24px 0; }
.state--error { color: #b23; }

src/main.jsx は、Vite のひな形のままで構いません(初期状態で App を読み込んでいます)。

確認: 開発サーバー(npm run dev)を開き直します。入力→+で増える、チェックで打ち消し線、✕で消える、残り件数が変わる——ここまで動けば、山を越えています。

そして、素のJS版との一番の違いを体で確かめてください。

入力欄に何か打っている途中で、一覧の項目をチェックしてみてください。 入力欄の打ちかけの文字が、消えません。 素のJS版の render() は一覧(<ul> の中)を丸ごと作り直していました。上の入力欄は一覧の外にあるので素のJS版でも文字は残りますが、もし一覧の中に入力欄(たとえば項目の編集欄)があれば、チェックのたびに作り直されて、打ちかけの文字もフォーカスも消えていたところです。React は変わった項目の1行だけを書き換えるので、入力欄は触られません。これが「全消し再描画からの卒業」です。

[スクリーンショット: 01_カーソルが飛ばない.png] 入力欄に文字を打ちかけたまま、一覧の項目のチェックを1つ切り替えた状態を撮ってください。打ちかけの文字が入力欄に残っていることが分かる形で。


③ コンポーネントに分ける — 部品にして、props で渡す

②の App.jsx は、1つの関数に全部入っています。 いまは短いので問題ありませんが、画面が増えると読めなくなります。部品(コンポーネント)に分けます。

分け方は素直に、見た目のかたまりで切ります。

App                      ← 状態(todos)を持つ。上から配る
├── AddForm              ← 入力欄と+ボタン
└── TodoList             ← 一覧
    └── TodoItem × 件数  ← 1行ぶん

src/components/ フォルダを作り、3ファイルを置きます。

bash
$ mkdir -p src/components

src/components/AddForm.jsx:

import { useState } from 'react'

export default function AddForm({ onAdd }) {
  const [text, setText] = useState('')

  function handleSubmit(e) {
    e.preventDefault()
    const value = text.trim()
    if (value === '') return
    onAdd(value)       // ⚠️ 追加は自分でやらない。親に「これを足して」と頼む
    setText('')
  }

  return (
    <form className="form" onSubmit={handleSubmit}>
      <input
        className="input"
        value={text}
        onChange={(e) => setText(e.target.value)}
        placeholder="やることを入力"
      />
      <button className="add" type="submit">+</button>
    </form>
  )
}

src/components/TodoItem.jsx:

import { Link } from 'react-router-dom'

export default function TodoItem({ todo, onToggle, onRemove }) {
  return (
    <li className={'item' + (todo.done ? ' done' : '')}>
      <input
        type="checkbox"
        checked={todo.done}
        onChange={() => onToggle(todo.id)}
      />
      <span className="text">{todo.text}</span>
      <Link to={'/todos/' + todo.id}>詳細</Link>
      <button className="del" onClick={() => onRemove(todo.id)}>✕</button>
    </li>
  )
}

src/components/TodoList.jsx:

import TodoItem from './TodoItem'

export default function TodoList({ todos, onToggle, onRemove }) {
  if (todos.length === 0) {
    return <p className="empty">まだ何もありません。上の欄から追加してください。</p>
  }
  return (
    <ul className="list">
      {todos.map((todo) => (
        <TodoItem
          key={todo.id}
          todo={todo}
          onToggle={onToggle}
          onRemove={onRemove}
        />
      ))}
    </ul>
  )
}

2つのルールだけ、腹に入れる

このコード全体を貫いているルールは、たった2つです。

1つめ。子は props を「受け取るだけ」。書き換えない。

TodoItem は todo を受け取って表示しますが、todo.done を自分で書き換えません。 チェックされたら onToggle(todo.id) を呼んで、親に「変えて」と頼むだけです。データを実際に変えるのは、状態を持っている親(App)です。

props は一方通行です。 上(親)から下(子)へ、値が流れるだけ。下から上へは、値ではなく「関数呼び出し(お願い)」が返ります。 この向きが決まっているから、「いま誰がデータを変えたのか」が追えます。

2つめ。状態は、それを使う全員の「共通の親」に置く。

todos は、TodoList(表示する)と AddForm(追加する)の両方が関わります。だから、どちらか片方ではなく、両方の親である App に置きます。 これを「状態のリフトアップ(持ち上げ)」と呼びます。素のJS版で todos を1つのグローバル変数にしていたのと、狙いは同じです。「どこに状態を置くか」を突き詰めていくと、いずれ状態管理の道具(Context など)の話につながりますが、3画面のこのアプリでは、まだ App に置くだけで足ります。

一方、AddForm の「入力中の文字(text)」は、AddForm の中だけの話です。他の誰も使いません。だから AddForm の中に置いたままです。

状態を置く場所の決め方: その状態を使うコンポーネントを全部挙げて、その全員の一番近い共通の親に置く。1人しか使わないなら、その1人の中に置く。「とりあえず一番上」に全部置くと、あとで見通しが悪くなります。

分けた部品を、App から組み立てる

src/App.jsx を、部品を呼び出すだけの形に書き換えます。状態(todos)と、それを変える3つの関数だけを持ち、あとは子に配ります。

import { useState } from 'react'
import AddForm from './components/AddForm'
import TodoList from './components/TodoList'
import './App.css'

export default function App() {
  const [todos, setTodos] = useState([])

  function add(text) {
    setTodos([...todos, { id: Date.now(), text, done: false }])
  }
  function toggle(id) {
    setTodos(todos.map((t) => (t.id === id ? { ...t, done: !t.done } : t)))
  }
  function remove(id) {
    setTodos(todos.filter((t) => t.id !== id))
  }

  const remaining = todos.filter((t) => !t.done).length

  return (
    <main className="app">
      <header className="head">
        <h1>やることリスト</h1>
        <span className="count">残り {remaining}件</span>
      </header>
      <AddForm onAdd={add} />
      <TodoList todos={todos} onToggle={toggle} onRemove={remove} />
    </main>
  )
}

②の1枚岩と、動きはまったく同じです。変わったのは「置き場所」だけ——入力欄は AddForm へ、一覧は TodoList と TodoItem へ移りました。App を見ただけで、このアプリが「フォームと一覧でできている」と分かるのが、分けたことの効き目です。②の return は、<form> も <ul> も全部その場に書いてあって、初めて読む人には一目では分かりませんでした。

確認: 開発サーバーで、②と同じに動けば成功です。見た目も動きも変わらないのに、ファイルは増えました。 「動きが変わらない変更」を、動きを壊さずにやり切ること自体が、部品化の練習です。次の④で画面が増えると、この分け方が効いてきます。

(App.jsx は次の④で、ルーティングを入れてもう一度書き換えます。ここでは「分けると App がこう薄くなる」を確認できれば十分です。)


④ 画面を増やす — 素のJSでつらかったところ

素のJS版は、1画面でした。 複数画面を作ろうとすると、「いまどの画面か」を自分の状態で管理して、if で出し分けて、ブラウザの「戻る」ボタンにも自分で対応して……と、つらすぎて諦めました。

React Router を使うと、これが道具で解けます。 URL に応じて画面を出し分け、「戻る」も効きます。

まず入れます。

bash
$ npm install react-router-dom

src/main.jsx を丸ごと置き換えます。アプリ全体を <BrowserRouter> で包むのがポイントです。

import React from 'react'
import ReactDOM from 'react-dom/client'
import { BrowserRouter } from 'react-router-dom'
import App from './App.jsx'
import './App.css'

ReactDOM.createRoot(document.getElementById('root')).render(
  <React.StrictMode>
    <BrowserRouter>
      <App />
    </BrowserRouter>
  </React.StrictMode>,
)

src/App.jsx を丸ごと置き換えます。状態(todos)は App に持ったまま、画面を <Routes> で切り替えます。

import { useState } from 'react'
import { Routes, Route, Link } from 'react-router-dom'
import AddForm from './components/AddForm'
import TodoList from './components/TodoList'
import TodoDetailPage from './pages/TodoDetailPage'

export default function App() {
  const [todos, setTodos] = useState([])

  function add(text) {
    setTodos([...todos, { id: Date.now(), text, done: false }])
  }
  function toggle(id) {
    setTodos(todos.map((t) => (t.id === id ? { ...t, done: !t.done } : t)))
  }
  function remove(id) {
    setTodos(todos.filter((t) => t.id !== id))
  }

  const remaining = todos.filter((t) => !t.done).length

  return (
    <main className="app">
      <header className="head">
        <Link to="/"><h1>やることリスト</h1></Link>
        <span className="count">残り {remaining}件</span>
      </header>

      <Routes>
        <Route
          path="/"
          element={
            <>
              <AddForm onAdd={add} />
              <TodoList todos={todos} onToggle={toggle} onRemove={remove} />
            </>
          }
        />
        <Route path="/todos/:id" element={<TodoDetailPage todos={todos} />} />
        <Route path="*" element={<p className="state">ページが見つかりません。</p>} />
      </Routes>
    </main>
  )
}

src/pages/TodoDetailPage.jsx を作ります。

bash
$ mkdir -p src/pages
import { useParams, Link } from 'react-router-dom'

export default function TodoDetailPage({ todos }) {
  const { id } = useParams()
  const todo = todos.find((t) => t.id === Number(id))  // ⚠️ URLの :id は文字列

  if (!todo) {
    return (
      <div className="detail">
        <p><Link to="/">← 一覧へ戻る</Link></p>
        <p className="state">この項目は見つかりませんでした。</p>
      </div>
    )
  }

  return (
    <article className="detail">
      <p><Link to="/">← 一覧へ戻る</Link></p>
      <p>{todo.done ? '完了' : '未完了'}</p>
      <h2>{todo.text}</h2>
    </article>
  )
}

つまずきやすい2点

useParams() が返す id は、文字列です。 URL は文字列なので、/todos/3 の 3 は文字の "3" です。一方 todo.id は Date.now() の数値です。t.id === id だと型が違って一生一致しません(3 === "3" は false)。だから Number(id) で数値に直します。JavaScript の「"1" と 1 は違う」という、いちばん最初にやった話が、ここで効いてきます。

一覧のリンクは <a> ではなく <Link> を使います。 <a href="/todos/3"> だと、クリックのたびにページ全体が再読み込みされ、todos(メモリ上の状態)が消えます。<Link> は再読み込みせずに画面だけ切り替えます。

確認: 一覧で項目を数件足し、「詳細」を押してください。URL が /todos/... に変わり、詳細画面が出て、「← 一覧へ戻る」で戻れます。ブラウザの「戻る」ボタンも効きます。 これを自分で書かずに済むのが、ルーターを使う理由です。

[スクリーンショット: 02_詳細画面.png] 一覧で「詳細」を押し、詳細画面(URL が /todos/... になっている)が表示されている状態を撮ってください。アドレスバーが読める形で。

新しい罠 — 本番で直リンクが404になる

開発中は気づきません。 npm run dev の開発サーバーは賢いので、/todos/3 を直接開いても動きます。ところが、ビルドして静的ホスティングに置くと、/todos/3 を直接開いた瞬間に 404 になります。

理由はこうです。静的ホスティングは、/todos/3 というURLを見て「todos/3 というファイルを探す」動きをします。そんなファイルはありません(あるのは index.html だけ)。だから「ファイルが無い=404」を返します。

一覧からリンクで移動する分には動くのに、/todos/3 をブックマークから直接開くと404、という分かりにくい壊れ方をします。「自分のPCでは動いたのに」の典型です。

対策は「どのURLでも index.html を返す」ようにサーバーに教えることです。これは /tasks/3 を直接開くと404 — ルーティング で詳しくやりました。⑥のデプロイで、この対策を実際に入れます。いまは「そういう罠がある」と覚えておけば十分です。


⑤ データを取得する — localStorageから一歩進む

素のJS版は localStorage に保存するだけでした。 それは「自分のブラウザの中」だけの話で、外からデータを取ってくることはできませんでした。 ここで、起動時にAPIから初期データを取得するようにします。

素のJS版で load() が localStorage から読んでいたところを、fetch に置き換えるイメージです。

useEffect で、起動時に1回だけ取りに行く

描画(画面を作ること)と、通信(外の世界と関わること)は、React では分けて考えます。通信は useEffect の中でやります。

src/App.jsx の App に、次を足します(useState に status を追加し、useEffect を入れます)。

import { useState, useEffect } from 'react'
// ...(import は省略。Routes / Route / Link / AddForm / TodoList / TodoDetailPage はそのまま)

export default function App() {
  const [todos, setTodos] = useState([])
  const [status, setStatus] = useState('loading')  // loading / error / done

  useEffect(() => {
    let ignore = false                              // ⚠️ 後述。開発中の二重実行よけ
    async function load() {
      setStatus('loading')
      try {
        const res = await fetch('https://jsonplaceholder.typicode.com/todos?_limit=5')
        if (!res.ok) throw new Error('通信に失敗しました(' + res.status + ')')
        const data = await res.json()
        if (ignore) return
        setTodos(data.map((t) => ({ id: t.id, text: t.title, done: t.completed })))
        setStatus('done')
      } catch {
        if (ignore) return
        setStatus('error')
      }
    }
    load()
    return () => { ignore = true }                  // ⚠️ 後片づけ
  }, [])                                            // ⚠️ [] = 起動時に1回だけ

  // add / toggle / remove は④のまま
  // ...
}

ここで使っている https://jsonplaceholder.typicode.com/todos は、誰でも叩ける練習用のダミーAPIです。本の一覧のような「本物」の代わりに、まず取得の形を体験するために使います。返ってくる { id, title, completed } を、このアプリの形 { id, text, done } に map で詰め替えています。

自分のバックエンドから取りたくなったら、この fetch の宛先を、作品のAPIと認証 で作ったAPI(例: /api/todos)に変えるだけです。画面側のコードは、ほとんど変わりません。

「動く」と「使える」の差は、4つの状態

ここは素のJS版には無かった、取得ならではの話です。 APIから取るということは、時間がかかるし、失敗しうるということです。1つの一覧には、状態が4つあります。

状態いつ何を出すか
読み込み中取りに行って、返事が来るまで待っていると分かるもの
エラー失敗した何が起きたか+もう一度試す手段
空成功したが、0件だったこれから何をすればいいか
正常成功して、1件以上あったデータ

「正常」だけ書くと、残り3つは全部「真っ白」という同じ見た目に潰れます。 読み込み中も、エラーも、0件も、見た目が同じ「何も出ていない」になり、使う人には区別が付きません。これがバグの無い「使えない画面」の正体です。詳しくは 「動く」と「使える」の差は4つの状態 と 取得のコードが200行になる — React深掘り にあります。

App.jsx の <Routes> の path="/" を、4状態を出し分ける形に変えます。

<Route
  path="/"
  element={
    <>
      <AddForm onAdd={add} />
      {status === 'loading' && (
        <p className="state" role="status">読み込んでいます…</p>
      )}
      {status === 'error' && (
        <p className="state state--error" role="alert">
          読み込めませんでした。ページを再読み込みしてください。
        </p>
      )}
      {status === 'done' && (
        <TodoList todos={todos} onToggle={toggle} onRemove={remove} />
      )}
    </>
  }
/>

「空」は、TodoList の中に既に書いてあります(③で todos.length === 0 のとき「まだ何もありません」を出しています)。ただし、その判定は status === 'done' になってからでないといけません。読み込み中も todos は [](0件)なので、先に空を出すと、通信中に「まだ何もありません」と言い切ってしまうからです。上のコードは status === 'done' のときだけ TodoList を出すので、これを避けています。

useEffect の落とし穴に、軽く触れる

useEffect は便利ですが、初めて使うと必ず1回踏みます。

  • 依存配列 [] を書き忘れると、描画のたびに実行される。 fetch の中で setTodos すると再描画 → また useEffect 実行 → また fetch …と無限ループになります。「起動時に1回だけ」なら [] を必ず付けます
  • 開発中(StrictMode)は、useEffect がわざと2回実行されます。 これは「後片づけ(return () => {...})を書き忘れていないか」をあぶり出すための、React の仕掛けです。上の ignore フラグは、先に始まった取得が後から返ってきても、古い結果を捨てるための後片づけです

ここでは「そういう罠がある」までで十分です。取得の設計に踏み込んだ話は 取得のコードが200行になる — React深掘り にまとめてあります。取得は、書き始めるとすぐ200行になる——それくらい状態の場合分けが多い、というのが向こうの回の主題です。

確認: 開発サーバーを開き直すと、一瞬「読み込んでいます…」が出て、ダミーAPIの5件が並べば成功です。

書いたら、4つとも自分の目で見てください。 「正常」しか見ないと、残り3つは書いたつもりで書けていないことがあります。わざと起こす手順は次のとおりです。

見たい状態起こし方
読み込み中開発者ツールの Network タブで、Throttling を「Slow 4G」にしてリロード
エラーfetch の宛先URLをわざと1文字変える(typicode → typicodex など)。直したら戻す
空URL の ?_limit=5 を ?_limit=0 にする(0件が返る)
正常そのまま。5件並ぶ

「エラーを自分で起こせること」自体が成果です。起こせないと、エラー画面が本当に出るのか確かめようがありません。素のJS版には無かった、取得ならではの確認です。


⑥ ビルドして公開する — 開発サーバーの外へ

開発サーバー(npm run dev)は、あなたのPCでしか動きません。 他人に見せるには、ビルドして、静的ホスティングに置きます。

ビルドする

bash
$ npm run build

dist/ フォルダができます。中を見てください。

bash
$ ls dist
assets  index.html  vite.svg

dist/ の中には、JSX も import も残っていません。 ブラウザがそのまま読める HTML / CSS / JS になっています。素のJS版で手書きしていた「ブラウザが読める形」を、Vite が機械的に作った——それが dist/ です。①で「なぜビルドが要るのか」と言ったことの、答えがこのフォルダです。

まず、手元で「本番の形」を見る

公開の前に、最悪でもこれで見られます。 npm run preview は、dist/ を本番と同じ静的配信の形で立ち上げます(npm run dev とは別物で、ビルド済みの dist/ を配ります)。

bash
$ npm run preview

出てきたURL(http://localhost:4173/ など)を開いて、開発時と同じに動けば、ビルドは成功です。公開先が用意できなくても、ここまでで「本番の形で動く」は確認できます。

静的ホスティングに出す

このアプリは、サーバーもデータベースも持ちません(データはダミーAPIから取るだけ)。だから、静的ホスティングに無料で置けます。 一番簡単なのは、素のJS版でもやったフォルダをドラッグする方法です。

  1. npm run build して dist/ を作る
  2. 静的ホスティングの「ドロップして公開」ページ(Netlify / Cloudflare Pages などにあります)を開く
  3. dist/ フォルダをそのまま枠にドラッグする
  4. 数十秒でURLが発行され、開くと手元と同じアプリが世界に出ている

git を覚えたあとの本格的な公開(GitHub Pages + 自動デプロイ)は、静的サイトは本当に無料で出せる — GitHub Pages で、この dist/ をそのまま出せます。

なぜ、バックエンドが無いのに公開できるのか

ここが分かれ目です。 このアプリが静的ホスティングで動くのは、データの取得先が、外部にある完成品のAPI(ダミーAPI)だからです。

fetch('https://jsonplaceholder.typicode.com/todos?_limit=5')  // ← 絶対URL。誰のサイトからでも叩ける

このダミーAPIは、どのサイトから叩かれてもいいように公開されて(CORSが許可されて)います。 だから、あなたの静的ホスティングのページから直接叩けます。「静的ホスティング=画面を配るだけ」で成り立つのは、データを外から借りているからです。

ところが、自分で作ったAPIに切り替えると、話が変わります。

ダミーAPI(いま)自分のAPI
置き場所相手が用意済み自分でどこかに動かし続ける必要がある
静的ホストだけで足りるか足りる足りない(APIを動かすサーバーが別に要る)
宛先の書き方絶対URL/api/...(同じ場所)にして、nginx でプロキシ

つまり、静的ホスティングへのドラッグで完結するのは「取得だけ・借り物データ」の段階までです。自分のデータで動く本物にするには、画面(静的)とAPI(常駐)の2つを動かす形になります。それをやり切るのが、次の「動く」と「使える」の差は4つの状態です。 いまは、まだそこに要りません。

2つの罠

罠1: base の設定で、CSS/JS が404になる。

GitHub Pages の「プロジェクトサイト」のように、https://ユーザー名.github.io/todo-react/ というサブパスの下で公開する場合、dist/index.html は /assets/... を絶対パスで読もうとして、/todo-react/assets/... にある本体を見つけられず、真っ白になります。画面は出るのに CSS も JS も当たっていない、という壊れ方です。

対策は、vite.config.js に base を書いてから npm run build し直すことです。

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  base: '/todo-react/',   // ⚠️ サブパスの下に置くとき。リポジトリ名に合わせる
})

ドラッグでルート直下(https://〇〇〇/)に置く場合は、base は要りません(初期値の / のまま)。サブパスに置くときだけ必要です。

罠2: ④で予告した、直リンクの404。

/todos/3 を直接開くと404になる件です。静的ホスティングでは「見つからないURLは index.html を返す」設定を入れます。 サービスによって書き方が違います。

  • Netlify / Cloudflare Pages: public/_redirects というファイルを作り、次の1行を書く(ビルドすると dist/ にコピーされます)
/*    /index.html   200
  • GitHub Pages: dist/index.html を dist/404.html としてコピーしておく(存在しないURLに 404.html が返り、その中の React が正しい画面を出す)

確認: 公開URL(または npm run preview)で、①一覧が出る ②項目の「詳細」で /todos/... に移れる ③/todos/1 をアドレスバーに直接打っても開ける(罠2の対策が効いている)、の3つを見ます。

[スクリーンショット: 03_公開して動く.png] 公開されたURL(または npm run preview のURL)を開き、一覧が表示されている画面を撮ってください。アドレスバーが読める形で。 まだ公開先を作っていなければ、npm run preview の画面で構いません。


静的ホスティングに置けたら、独自ドメインを付けるとポートフォリオとして人に渡しやすくなります。XServerドメインは取得・更新・移管の表示価格以外に維持調整費やオプション料金がかからない料金体系で、はじめて使う人向けに .com の取得が 0円、通常は取得・更新とも 1,721円です(税込、2026-11 時点)。0円は初回かつ対象ドメインのいずれか1つだけで、終了日の記載が無く予告なく変更・終了する場合があるので、申し込み時点の価格一覧で確かめてください。

⑦ 完成の判定 — 自分で「できた」と言えるように

「なんとなく動く」で終わらせません。 この6つを自分で通したら、React コースの到達作品として完成です。

□ Vite で作った開発サーバーで動く(npm run dev)
□ useState で、追加・完了・削除すると一覧がすぐ更新される(render() を書いていない)
□ コンポーネント(AddForm / TodoList / TodoItem)に分かれ、props で繋がっている
□ 一覧 / と 詳細 /todos/:id の2画面を、ルーティングで行き来できる
□ APIから取得し、読み込み中・エラー・空・正常の4状態を出せる
□ npm run build して公開できる(またはローカルの npm run preview で本番の形で見られる)

1つでも通らなかったら、それがこのコースの「まだ手が届いていない場所」です。 そこだけ、対応する回に戻ればいい。この判定リストが、「読んだ」を「作れる」に変えます。


つまずいたところ

チェックしても画面が変わらなかった。 todos[i].done = true と、配列を直接書き換えていました。React は「新しい配列が来たか」で描き直すので、中身を書き換えても気づきません。 setTodos(todos.map(...)) で新しい配列を渡す形に直したら動きました。

Each child in a list should have a unique "key" prop という警告が消えなかった。 key を <li> ではなく、その中の <span> に付けていました。key は、map が返す一番外側の要素に付けます。 ここでは <TodoItem key={todo.id} ... /> の位置です。

詳細画面が、いつも「見つかりませんでした」になった。 t.id === id で比べていました。useParams の id は文字列なので、数値の todo.id と型が合いません。Number(id) にしたら直りました。素のJS版でやった「"1" と 1 は違う」そのものです。

リンクを押すたびに、追加した項目が全部消えた。 一覧のリンクを <a href> で書いていました。<a> はページ全体を再読み込みするので、メモリ上の todos が消えます。 <Link> に変えて解決。「戻る」でも消える場合は、そもそも状態が保存されていないためで、これは仕様です(保存するなら素のJS版の localStorage かAPIを使います)。

開発サーバーでは動いたのに、公開したら真っ白になった。 サブパスに置いたのに base を設定していませんでした。vite.config.js に base を書いて npm run build し直す必要があります。開発サーバーは base を無視して動くので、ビルドするまで気づけませんでした。

公開後、トップは出るのに /todos/1 を直接開くと404だった。 ④で予告した罠です。「見つからないURLは index.html を返す」設定(_redirects か 404.html)を入れ忘れていました。入れたら直りました。

APIを叩くコードが、無限に実行され続けた。 useEffect の依存配列 [] を書き忘れ、fetch の中の setTodos で再描画 → また useEffect … とループしていました。「起動時に1回だけ」なら [] を必ず付けます。 Network タブが同じ要求で埋まっていて気づきました。

開発中、APIが2回叩かれていた。 バグではなく、StrictMode がわざと2回実行していました。後片づけ(return () => { ignore = true })を書いておけば、古い結果は捨てられるので、実害はありません。本番ビルドでは2回実行はされません。


後片づけ

このアプリは、消す必要はありません。 サーバーもプロセスも常駐していないので、todo-react/ フォルダを残しておけば、そのまま自分のツールとして使えます。開発サーバー(npm run dev / npm run preview)は、ターミナルで Ctrl+C を押せば止まります。

容量が気になる場合は、node_modules/ が重いので、使わないなら消して構いません。もう一度使うときに npm install で戻ります(node_modules/ は生成物で、消してよいフォルダです)。dist/ も生成物なので、消しても npm run build で作り直せます。

公開先を消したいときは、ドラッグで作ったサイトなら、そのサービスの管理画面から削除します。無料枠でも、放置で課金が発生することはありません(静的ファイルを置いているだけなので)。


まとめ — 理解できたこと

  • 素のJS版の render()(全消しして作り直す)を、React では書かなくてよくなった。 状態を変えると、React が変わったところだけ書き換える
  • その結果、入力途中でも入力欄のカーソルが飛ばなくなった。 これが「全消し再描画からの卒業」で、React を使う一番の理由
  • 状態は useState で持つ。 素のJSの let todos が const [todos, setTodos] になった
  • 状態を直接書き換えてはいけない。 todos.push は効かず、setTodos([...todos, x]) のように新しい配列を渡す
  • 一覧には key を付ける。 添字ではなく、変わらない id を使う(素のJSの「削除は添字でなく id で」と同じ理由)
  • コンポーネントに分けると、2つのルールに集約される。 子は props を受け取るだけ(書き換えない)/状態は使う全員の共通の親に置く
  • 素のJSでつらかった「複数画面」は、React Router で解けた。 URL で画面を出し分け、「戻る」も効く
  • ただし本番では、直リンクが404になる新しい罠が出る。 「見つからないURLは index.html を返す」設定で対処する
  • 素のJSではできなかった「APIからの取得」ができた。 useEffect で起動時に1回だけ叩く
  • 取得には状態が4つある。 読み込み中・エラー・空・正常。正常だけ書くと、残り3つは「真っ白」に潰れる
  • useEffect は依存配列 [] を忘れると無限ループする。 開発中の2回実行は StrictMode の仕掛けで、後片づけを書けば実害は無い
  • npm run build で dist/ を作り、静的ホスティングに置く。 公開先が無くても npm run preview で本番の形は見られる
  • base の設定を忘れると、サブパス公開で CSS/JS が404(真っ白)になる

そして、これがReactを使う理由

素のJS版を思い出してください。 動くものは作れましたが、最後に「全消し再描画がつらい」「複数画面がつらい」「外からデータを取れない」の3つが残りました。

この記事で、その3つが全部消えました。 全消し再描画は useState が引き受け、複数画面は React Router が、データ取得は useEffect + fetch が解きました。しかも、素のJSで手書きした「状態から画面を作る」考え方は、そのまま生きています。

フレームワークは、魔法ではありません。 素のJSでやっていたことを、効率よく・安全に・自動でやってくれる道具です。あなたはもう手で書けるから、道具のありがたみが分かります。

そして、この「やることリスト」は、ここで完成ではありません。 Backendの到達作品で作ったAPIと繋げば、ダミーAPIが本物のデータに変わり、「みんなで使える本物の作品」になります。 その組み上げ方は 「動く」と「使える」の差は4つの状態 にあります。React コースの到達点は、フルスタックの入口でもあります。


参考リンク


次に読む

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

記事
← 前の記事divのボタンはキーボードで押せない — アクセシビリティ
→ 次の記事クラス名を考えるのをやめる — Tailwind CSS

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

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

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

React コースの到達作品です。 素のJSで作ったアプリを React で書き直し、画面とデータ取得を足します。

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

コメント

コメントする

目次