コンポーネントは見た目の部品ではない — propsと状態

Reactのコンポーネント。画面を構成する交換可能な部品と状態のカード、一方向に渡す封筒。

あのコードは、いま src/App.jsx という1つのファイルの、App という1つの関数に、全部入っています。 80行ほどです。

前回: 手でDOMを書き換えるのをやめる — React・Vue・Svelte 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。前回作った ~/react-demo/ をそのまま使います。

前回、React でタスクリストを書き直しました。querySelector も createElement も消えて、残ったのは「データと見た目の対応関係」だけになりました。

80行は短い、と思うかもしれません。 ですが、あの中にはすでに4つの別々の仕事が同居しています。

  • タスクの配列を持つ(データの管理)
  • 入力欄の文字を持つ(入力の管理)
  • 件数を数えて出す(集計の表示)
  • 1件ずつを行として並べる(一覧の表示)

ここに「完了だけ隠す」を足すとどうなるか。 App の中に、チェックボックスの状態が1つ増え、tasks.map() の前に filter が1つ増え、件数の計算がどちらを数えるべきかで悩むことになります。そして、入力欄を直そうとして一覧を壊します。

この記事は「ファイルの分け方」の記事ではありません。「どこで割るか」と「割った後、状態をどこに置くか」の記事です。後者が、React で最初に道が分かれるところです。

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

目次

この記事でわかること

  • コンポーネントは「見た目の部品」ではなく、「状態と表示をひとかたまりにしたもの」だということ。ファイルを分けることが目的ではない
  • props は親から子への一方通行であること。子が props を書き換えても、エラーも出ないまま画面が変わらない理由
  • 2つの子が同じデータを見るなら、状態は共通の親に置く(リフトアップ)。子がそれぞれコピーを持つと、静かにずれる
  • 分けすぎると、かえって直しにくくなること。1画面1コンポーネントで始めて、困ってから割るのが正しい順番

この記事でやること

  1. 前回の App.jsx を読み直し、1つの関数の中で何と何が混ざっているかを線で分ける
  2. src/components/ を作り、TaskForm / TaskList / TaskItem の3つに割る(全ファイルの中身を出します)
  3. 件数表示 TaskSummary を、わざと間違ったやり方(子が自分で状態を持つ)で作って壊す
  4. 状態を親に引き上げて直す(リフトアップ)
  5. props を子から書き換えると何が起きるかを、自分の手で確かめる

先に知る言葉

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

言葉意味
コンポーネント見た目を返す関数。React では、大文字で始まる名前の関数がそれになる
props親が子に渡すデータ。子から見ると読み取り専用の引数
単方向データフローデータは親から子へしか流れないという決まり。逆向きは関数を渡して知らせる
リフトアップ(lift state up)状態を、それを使う全員の共通の親まで引き上げること
信頼できる唯一の情報源同じ意味のデータを2箇所に持たないという考え方。持つとずれる
バケツリレー(prop drilling)使わない中間の階層を、props がただ通り抜けていく状態
分割代入function F({ a, b }) のように、渡ってきたオブジェクトから中身を名前で取り出す書き方

「コンポーネント」という言葉は、日本語だと「部品」と訳されます。 この訳のせいで、9割の人が最初に誤解します。 「ボタン」「カード」のような見た目の単位を思い浮かべるからです。 React のコンポーネントは、見た目の単位ではありません。 「この見た目は、どのデータから決まるか」という対応関係の単位です。データが同じなら、見た目がいくつに分かれていても1つのコンポーネントでいい。逆に、見た目は1つでも、別のデータで動くなら分けたほうがいい。 これがこの記事の芯です。


① 準備 — 前回の続きから

VMの中で、前回のディレクトリに入ります。

bash
$ cd ~/react-demo
$ ls src
App.css  App.jsx  assets  index.css  main.jsx

このファイル一覧が出れば、前回の続きです。 出ないときは前回のフレームワークの回からやり直してください。

前回の後片づけで 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

ホストの Windows のブラウザで http://192.168.226.50:5173/(IPは自分の値に。分からなければ VM の中で ip a)を開き、前回のタスクリストが動いていることを確認してから先へ進んでください。

止め方: ターミナルで Ctrl+C。この記事の間は、起動したままで構いません。 保存するたびにブラウザが勝手に切り替わります(HMR)。


② いまの App.jsx に線を引く

まず、直す前に読みます。 これが前回書いたものです(src/App.jsx)。

import { useState } from "react";

function App() {
  const [tasks, setTasks] = useState([]);      // ← A: タスクの配列
  const [text, setText] = useState("");        // ← B: 入力欄の文字

  const add = () => {                          // ← B と A の両方を触る
    if (text === "") return;
    setTasks([...tasks, { id: Date.now(), title: text, done: false }]);
    setText("");
  };

  const toggle = (id) => { /* A を触る */ };
  const remove = (id) => { /* A を触る */ };

  const remaining = tasks.filter((t) => !t.done).length;   // ← C: 集計

  return (
    <div className="app">
      <h1>やること</h1>
      <input ... />                            {/* ← B を表示 */}
      <button onClick={add}>追加</button>       {/* ← B を使う */}
      <p>残り {remaining} 件 ...</p>            {/* ← C を表示 */}
      <ul>{tasks.map(...)}</ul>                {/* ← A を表示 */}
    </div>
  );
}

A・B・C が、上から下まで交互に出てきます。

ここが苦しさの正体です。

「入力欄を直したい」と思ったとき、App の全体を読まないと直せません。 text に触っている場所が、上(useState)・真ん中(add)・下(<input>)に散っているからです。 そしてその途中には、入力欄とは何の関係もない tasks の処理が挟まっています。

80行でこれです。 機能が5つ増えれば300行になり、そのときには「どこを直すと何が壊れるか」が誰にも分からなくなります。 自分が3日前に書いたものでも同じです。

割る線は、見た目ではなくデータで引く

<input> と <button> を「フォームだから」という理由で分けるのではありません。

text という状態は、<input> と <button> と add の3つでしか使われていません。 App の他の部分は、text の存在すら知らなくていい。

この「知らなくていい」が見つかったところが、割る線です。

状態使っている場所結論
text(入力中の文字)入力欄・追加ボタンだけその3つで1つの部品にできる。App から見えなくなる
tasks(タスクの配列)一覧・件数・追加・完了・削除みんなが使う。だから App に残す

text は下ろせる。tasks は下ろせない。 これが割り方の答えです。見た目からは、この線は引けません。


③ props — 親から子へ、一方通行

割ると、親と子の間でデータを渡す必要が出ます。 その仕組みが props です。

props は、関数の引数です。それ以上のものではありません。

// 子(受け取る側)
function Hello(props) {
  return <p>こんにちは、{props.name} さん</p>;
}

// 親(渡す側)
<Hello name="たろう" />

name="たろう" と書いたものが、子では props.name になります。

実際には、こう書くほうが多いです。

function Hello({ name }) {
  return <p>こんにちは、{name} さん</p>;
}

これは分割代入で、渡ってきたオブジェクトから name だけ取り出しているだけです。動きは上と全く同じです。この記事ではこちらを使います。

渡せるのは文字列だけではない

<Task title="買い物" count={3} done={true} task={obj} onDelete={handleDelete} />
書き方渡るもの
title="買い物"文字列。このときだけクォートでよい
count={3}数値。count="3" は文字列の "3" になる(JSの回でやった "1" と 1 の話)
done={true}真偽値。done とだけ書いても true になる
task={obj}オブジェクトや配列
onDelete={handleDelete}関数。これが重要です(後述)

count={3} の {} は、JSXのオブジェクト記法ではありません。 前回やった 「ここからは JavaScript の式ですよ」という合図です。だから {} の中には変数も計算も書けます。 数値や真偽値を渡すのに {} が要るのは、そのためです。

子が props を書き換えてはいけない

これが、この記事で一番大事な決まりです。

// ❌ やってはいけない
function TaskItem({ task }) {
  const handleClick = () => {
    task.done = !task.done;      // ← 親から渡ってきたオブジェクトを直接書き換えている
  };
  return <span onClick={handleClick}>{task.title}</span>;
}

エラーは出ません。 task.done の値も、実際に変わります。それなのに、画面は1ミリも変わりません。

理由は、前回やったことと同じです。

React が「変わった」と気づくのは、useState が返した set... が呼ばれたときだけです。 オブジェクトを直接書き換えても、React には何も伝わりません。

さらに悪いことに、この書き方は「親の持ち物を、親に断りなく書き換えている」状態です。親の tasks の中身が、親が知らないうちに変わっています。 あとで親が setTasks(...) を呼んだ瞬間に、なぜか違う値になっているという、追いにくいバグになります。

では、子はどうやって「押されました」を親に伝えるのか。

親が、子に「関数」を渡します。 子は、その関数を呼ぶだけ。 実際にデータを書き換えるのは、あくまで親です。

// 親
<TaskItem task={task} onToggle={toggleTask} />

// 子
<span onClick={() => onToggle(task.id)}>{task.title}</span>

子がやっているのは「id が 123 のものが押されました」と報告することだけです。それをどう扱うか(完了にする / 削除する / 何もしない)は、全部親が決めます。

向き何が流れるか
親 → 子データ(props)
子 → 親「何が起きたか」の報告(親から渡された関数を呼ぶ)

これが「単方向データフロー」です。データは下にしか流れず、上に戻るのは出来事の知らせだけ。

なぜここまで厳しくするのか。 どこでもデータを書き換えられると、「この値を変えたのは誰か」を探すのに全ファイルを読むことになるからです。 書き換える場所を親1箇所に固定すれば、おかしくなったときに見る場所も1箇所です。窮屈さは、追跡できることと引き換えになっています。


④ 実際に割る

ここから手を動かします。 ディレクトリを作ります。

bash
$ mkdir -p ~/react-demo/src/components

components/ という名前に、React 側の決まりはありません。 src/parts/ でも動きます。 ただ、多くのプロジェクトがこの名前を使っているので、他人のコードを読むときに揃っていたほうが楽です。

これから作るファイルは4つ、書き換えるファイルは2つです。

ファイル役割持つ状態
src/App.jsx(書き換え)タスクの配列を持ち、追加・完了・削除を実行するtasks
src/components/TaskForm.jsx(新規)入力欄と追加ボタンtext
src/components/TaskList.jsx(新規)一覧の枠(<ul>)なし
src/components/TaskItem.jsx(新規)1件分の行なし
src/components/TaskSummary.jsx(新規)件数の表示なし(⑤で作ります)
src/index.css(書き換え)見た目—

まず4つのうち3つを作ります。 TaskSummary は⑤で、わざと間違えるところから作ります。

src/components/TaskItem.jsx(新規)

function TaskItem({ task, onToggle, onRemove }) {
  return (
    <li>
      <span
        onClick={() => onToggle(task.id)}
        className={task.done ? "done" : ""}
      >
        {task.title}
      </span>
      <button onClick={() => onRemove(task.id)}>削除</button>
    </li>
  );
}

export default TaskItem;

useState が1つもありません。 渡された task を、そのまま見た目に置き換えているだけです。

こういう、状態を持たないコンポーネントを「表示だけの部品」と呼びます。 同じ props を渡せば必ず同じ見た目になるので、壊れようがありません。 テストもしやすく、読むのも一瞬です。 状態を持たせずに済むなら、持たせない。 これは後々まで効く方針です。

src/components/TaskList.jsx(新規)

import TaskItem from "./TaskItem.jsx";

function TaskList({ tasks, onToggle, onRemove }) {
  if (tasks.length === 0) {
    return <p className="empty">まだ何もありません。上の欄から追加してください。</p>;
  }

  return (
    <ul>
      {tasks.map((task) => (
        <TaskItem
          key={task.id}
          task={task}
          onToggle={onToggle}
          onRemove={onRemove}
        />
      ))}
    </ul>
  );
}

export default TaskList;

2つ、注意点があります。

1つめ。key は TaskItem に付けます。 TaskItem の中の <li> ではありません。key は「map で並べている、まさにその場所」に付けるものです。理由と、key={index} にしてはいけない話は前回に書いたので繰り返しません。

2つめ。return が2つあります。 上の if に入ったら、そこで関数は終わります。 「0件のときは別の見た目を返す」という、普通の JavaScript の早期 return です。JSX を返す関数も、ただの関数だということがここで効いています。

src/components/TaskForm.jsx(新規)

import { useState } from "react";

function TaskForm({ onAdd }) {
  const [text, setText] = useState("");

  const handleSubmit = (e) => {
    e.preventDefault();
    if (text === "") return;
    onAdd(text);
    setText("");
  };

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="text"
        value={text}
        placeholder="何か入力"
        onChange={(e) => setText(e.target.value)}
      />
      <button type="submit">追加</button>
    </form>
  );
}

export default TaskForm;

text が、App から完全に消えました。 App は「何を入力中か」を知りません。知る必要もありません。 知らされるのは、追加が確定したときの文字列だけです。

<form> と onSubmit にしたのは、Enterキーで送信できるようにするためです。<button> を押しても、入力欄で Enter を押しても、同じ handleSubmit が動きます。 e.preventDefault() は必須です。 これが無いと、ブラウザ本来の動き(ページごと送信して再読み込み)が走り、入力が消えて画面が真っ白に戻ります。 DOM操作の回で扱った「既定の動作を止める」が、ここで出てきます。 試しに e.preventDefault(); の行を消して追加してみてください。 一瞬ページが再読み込みされます。確かめたら戻してください。

src/App.jsx(丸ごと置き換え)

import { useState } from "react";
import TaskForm from "./components/TaskForm.jsx";
import TaskList from "./components/TaskList.jsx";

function App() {
  const [tasks, setTasks] = useState([]);

  const addTask = (title) => {
    setTasks([...tasks, { id: Date.now(), title, done: false }]);
  };

  const toggleTask = (id) => {
    setTasks(tasks.map((t) => (t.id === id ? { ...t, done: !t.done } : t)));
  };

  const removeTask = (id) => {
    setTasks(tasks.filter((t) => t.id !== id));
  };

  return (
    <div className="app">
      <h1>やること</h1>
      <TaskForm onAdd={addTask} />
      <TaskList tasks={tasks} onToggle={toggleTask} onRemove={removeTask} />
    </div>
  );
}

export default App;

App の return を読んでください。 「入力欄がある。一覧がある」しか書いてありません。 どういう <input> なのか、<li> がどう並ぶのかは、もう App の関心事ではありません。

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;
}

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>,
)

このファイルは触りません。 querySelector が出てくるのは、今日もここ1箇所だけです。

確認する

bash
$ ls -R src
src:
App.css  App.jsx  assets  components  index.css  main.jsx

src/components:
TaskForm.jsx  TaskItem.jsx  TaskList.jsx

[スクリーンショット: 01_src構成.png] ls -R src の結果を撮ってください。components/ の中に3つ並んでいるのが分かる形で。

ブラウザを見てください。 見た目は、割る前とまったく同じはずです(件数の表示だけが消えています。⑤で戻します)。追加・取り消し線・削除が動けば成功です。

戻し方: App.jsx を前回のものに書き戻せば、それだけで元に戻ります。 components/ は残っていても、import されなければ何もしません。丸ごとやり直したいときは rm -rf ~/react-demo して npm create vite@latest から。

ここで「で、何が良くなったのか?」と思って構いません。 ファイルが増えただけで、動きは1つも変わっていないからです。良くなったのは「変えるときの手間」だけで、それは次に変えるときにしか実感できません。 だから、割るのは「変えにくくなってから」でいい。 ここは⑦でもう一度書きます。


⑤ 状態をどこに置くか — 最初の分かれ道

件数表示を戻します。 ここが、この記事の本題です。

まず、間違えます

「件数を出す部品なんだから、件数はその部品が持てばいい」と考えるのが自然です。やってみます。

src/components/TaskSummary.jsx を、わざとこう書きます。

// ❌ これは動きません(あとで直します)
import { useState } from "react";

function TaskSummary() {
  const [count, setCount] = useState(0);
  return <p>残り {count} 件</p>;
}

export default TaskSummary;

書いた瞬間に、問題が2つ見えます。

  • setCount を呼ぶ場所がありません。 タスクが追加されたことを、この部品は知りようがない
  • 数える元の tasks を、この部品は持っていません

では、と App から tasks を渡して、それを自分の状態にコピーしてみます。

// ❌ これも動きません
function TaskSummary({ tasks }) {
  const [count, setCount] = useState(tasks.filter((t) => !t.done).length);
  return <p>残り {count} 件</p>;
}

動きません。 正確には、最初の1回だけ正しくて、その後は永久に古いままになります。

useState(初期値) の「初期値」は、本当に最初の1回しか使われません。 2回目以降、その部品が再レンダリングされても、useState は「いま持っている値」を返します。 初期値の式は無視されます。 これは仕様です。 そうでなければ、入力欄に打った文字が再レンダリングのたびに消えてしまいます。

[スクリーンショット: 02_件数が0のまま.png] 上の❌のコードを入れた状態で、タスクを3件追加しても「残り 0 件」のままになっている画面を撮ってください。一覧には3件並んでいるのが同時に見える形で。

何が間違っていたのか

根っこは、前回書いたことと同じです。

同じ意味のデータを、2箇所に持ちました。 1つは App の tasks。もう1つは TaskSummary の count。 この2つを一致させ続ける責任が、また自分に戻ってきています。

前回、素のJavaScript で「配列とDOM」がずれた話をしました。 今回ずれているのは「親の状態と子の状態」です。形が違うだけで、同じ病気です。

直し方 — 状態を親に引き上げる(リフトアップ)

判断の手順は、いつもこの3つです。

  1. そのデータを使っているコンポーネントを、全部書き出す
  2. その全員から見て、共通の親はどれかを探す
  3. 状態は、その共通の親に置く

今回で言えば、

使っているのは
TaskList(一覧を出す)tasks が要る
TaskSummary(件数を数える)tasks が要る
共通の親App

だから tasks は App に置きます。 TaskSummary は状態を持たず、渡された tasks から毎回計算します。

src/components/TaskSummary.jsx を、こう書き直します(これが最終形です)。

function TaskSummary({ tasks }) {
  const remaining = tasks.filter((t) => !t.done).length;

  return (
    <p>
      残り {remaining} 件 / 全 {tasks.length} 件
    </p>
  );
}

export default TaskSummary;

useState も import も要りません。

src/App.jsx に2行足します(import 行と、<TaskSummary /> の行)。全文を出します。

import { useState } from "react";
import TaskForm from "./components/TaskForm.jsx";
import TaskSummary from "./components/TaskSummary.jsx";
import TaskList from "./components/TaskList.jsx";

function App() {
  const [tasks, setTasks] = useState([]);

  const addTask = (title) => {
    setTasks([...tasks, { id: Date.now(), title, done: false }]);
  };

  const toggleTask = (id) => {
    setTasks(tasks.map((t) => (t.id === id ? { ...t, done: !t.done } : t)));
  };

  const removeTask = (id) => {
    setTasks(tasks.filter((t) => t.id !== id));
  };

  return (
    <div className="app">
      <h1>やること</h1>
      <TaskForm onAdd={addTask} />
      <TaskSummary tasks={tasks} />
      <TaskList tasks={tasks} onToggle={toggleTask} onRemove={removeTask} />
    </div>
  );
}

export default App;

保存してブラウザを見てください。 追加しても、完了にしても、削除しても、件数は必ず合っています。

[スクリーンショット: 03_リフトアップ後.png] タスクを3件追加し、1つを完了(取り消し線)にした状態を撮ってください。「残り 2 件 / 全 3 件」が見える形で。

覚えるのは、この一文だけ

状態は「それを使う全員の、いちばん近い共通の親」に置く。 それより下に置くと、他の子から見えない。 それより上に置くと、関係ない階層を通り抜けることになる。

そして、もう1つ。

計算で出せるものを、状態にしない。 remaining は tasks から必ず計算できます。 だから useState にしてはいけません。 状態にした瞬間、「tasks を変えたら remaining も変える」という責任が発生します。 計算にしておけば、その責任は最初から存在しません。

これは、初心者が最もよくやる useState の使いすぎです。useState を書く前に、必ず「これ、他の状態から計算できないか?」と聞いてください。

持ち方例判定
useState にする入力中の文字、タスクの配列他から計算できない。外から来る
ただの変数で計算する残り件数、全件数、「0件かどうか」tasks から必ず出せる

⑥ props を書き換えると、本当にどうなるか

③で「子が props を書き換えてはいけない」と書きました。 実際に破ってみます。 理屈で覚えるより速いです。

src/components/TaskItem.jsx の onClick を、一時的にこう変えます。

      <span
        onClick={() => { task.done = !task.done; }}
        className={task.done ? "done" : ""}
      >

保存して、タスクの文字をクリックしてください。

何も起きません。 取り消し線も付かず、件数も変わらず、Console にエラーも警告も出ません。

では、値は変わっていないのか。 変わっています。 その証拠に、そのあとで別のタスクを1件追加してみてください。

さっきクリックしたタスクに、突然、取り消し線が付きます。

何が起きたか。 task.done の書き換え自体は成功していました。 ただReact に伝わっていなかったので、画面が作り直されなかっただけです。 そして「追加」で setTasks が呼ばれた瞬間、React は画面を作り直します。 そのとき初めて、さっき裏で書き換えられていた値が表に出てきます。

これが「静かに壊れる」という言葉の意味です。

  • クリックした瞬間には、何も起きない
  • 無関係な操作をしたときに、突然、過去の操作が反映される
  • エラーは1つも出ない

この手のバグは、原因にたどり着くまでに何時間もかかります。 だから React は「状態を直接いじるな」と、しつこく言います。

戻してください。

        onClick={() => onToggle(task.id)}

ちなみに、前回出てきた <StrictMode> は、この手の「直接いじる書き方」を見つけやすくするために、開発中だけわざと処理を2回走らせています。 main.jsx から外したくなっても、外さないでください。 うるさいのには理由があります。


⑦ 分けすぎない

ここまで読むと、「もっと細かく分けたほうが良さそう」と思うはずです。 止めてください。

やりがちなのが、これです。

// ❌ 分けすぎ
function Title({ text }) {
  return <h1>{text}</h1>;
}

function DeleteButton({ onClick }) {
  return <button onClick={onClick}>削除</button>;
}

何も悪いことはしていません。 ですが、得たものが1つもありません。

期待現実
「再利用できる」1箇所でしか使っていない
「読みやすくなる」<h1> を見るのに、別ファイルを開くことになった
「変更に強い」文字を変えるのに、親と子の2ファイルを行き来する

コンポーネントに割ると、必ずコストが発生します。 props という「受け渡しの取り決め」が1つ増えるからです。取り決めは、増えるほど覚えることが増えます。 そのコストを払う価値があるのは、「状態を隠せるとき」か「同じものを2箇所以上で使うとき」だけです。

この記事で割った4つは、全部その基準を通っています。

部品割った理由
TaskFormtext という状態を、App から隠せた
TaskItemtasks.map() の中身が長く、App の return が読めなくなっていた
TaskList「0件のとき」という分岐を、一覧の中に閉じ込められた
TaskSummary「残り件数とは何か」の定義が1箇所に集まった。 数え方を変えるとき、開くファイルが1つで済む

逆に言えば、この4つ以外は割りませんでした。 <h1> も <button> も、そのまま置いてあります。

正しい順番

1画面を1つのコンポーネントで書き始める。 長くなって読めなくなってから、状態の使われ方を見て割る。

「あとから割る」のは簡単です。 切り出して、props を渡すだけです。先に細かく割ってしまうと、あとから「実はこの2つは同じ状態を見ていた」と分かったときに、作り直しになります。

「最初から正しく設計する」ことは、できません。 どの状態が誰に必要かは、機能を足してみるまで分かりません。 これは腕の問題ではなく、情報が足りていないだけです。


⑧ この先に起きること — バケツリレー

いまの構造を見てください。

App                    ← tasks を持っている
├── TaskForm           ← onAdd を受け取る
├── TaskSummary        ← tasks を受け取る
└── TaskList           ← tasks, onToggle, onRemove を受け取る
    └── TaskItem       ← task, onToggle, onRemove を受け取る

TaskList に注目してください。

TaskList は onToggle を使っていません。 TaskItem に渡すためだけに受け取っています。

これが「バケツリレー(prop drilling)」の始まりです。いまは1段だけなので、何ともありません。ですが、階層が5段、10段になると、こうなります。

  • 途中の8個のコンポーネントが、自分では使わない props を書き並べる
  • 一番下で props を1つ増やすたびに、途中の8ファイル全部を直す
  • どこから来た値なのかを追うのに、8ファイルを遡る

ここまで来たときに初めて、こういう道具が意味を持ちます。

道具やること
ContextReact 本体の機能。途中を飛ばして、遠い子に直接渡す
Zustand / Redux状態管理ライブラリ。状態をコンポーネントの外に出す

この記事では入れません。 前回書いた理由がそのまま当てはまります。 いま困っていないからです。1段のバケツリレーのために状態管理ライブラリを入れると、「React の機能」と「ライブラリの機能」の区別が付かなくなります。 「途中の階層が props を書き写しているだけだ」と自分の手で感じてから入れてください。そのとき初めて、そのライブラリが何を解いているかが分かります。

覚えておいてほしいのは、順番だけです。

props で足りなくなってから Context。Context で足りなくなってからライブラリ。 逆から入ると、どれも分かりません。


つまずいたところ

TaskForm is not defined → import を書いていません。ファイルを作っただけでは使えません。 App.jsx の先頭に import TaskForm from "./components/TaskForm.jsx"; が要ります。

Failed to resolve import "./components/TaskForm.jsx" → パスが違います。 ./ は「このファイルと同じ場所から」という意味です。App.jsx は src/ にあるので、./components/... になります。ファイル名の大文字・小文字も一致させてください。 Linux は区別します(taskform.jsx では見つかりません)。

画面が真っ白になり、Console に Element type is invalid → export default を書き忘れています。 各ファイルの最後の1行を確認してください。

タグを書いたのに、画面に何も出ない(エラーも無い) → コンポーネント名が小文字です。<taskForm /> と書くと、React は「そういう名前のHTMLタグ」だと解釈して、そのまま出そうとします。必ず大文字始まりにしてください。これが、名前が大文字で始まる理由そのものです。

「追加」を押すとページが再読み込みされ、入力が消える → e.preventDefault() を書いていません。 <form> の既定の動作です。

件数だけが更新されない → TaskSummary が自分で useState を持っています。 ⑤のとおり、渡された tasks から計算してください。

クリックしても取り消し線が付かないのに、別の操作をすると突然付く → task.done = ... のように props を直接書き換えています。 ⑥のとおりです。onToggle(task.id) にしてください。

Cannot read properties of undefined (reading 'filter') → props の名前が親と子で食い違っています。 親で <TaskSummary items={tasks} /> と書いて、子で { tasks } と受けている、など。綴りは完全一致である必要があります。

Console に Each child in a list should have a unique "key" prop → key を TaskItem ではなく、その中の <li> に付けています。 map している場所に付けてください(前回)。

ホストのブラウザから繋がらない → sudo ufw allow 5173/tcp の忘れか、--host 0.0.0.0 の付け忘れです。①に戻ってください。


後片づけ

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

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

~/react-demo/ は、次の回でも使うので残してください。 この形(App が状態を持ち、子が表示する)が、この先の土台になります。

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

bash
$ rm -rf ~/react-demo

~/vite-demo/(Vanilla)と ~/web/(素のHTML)も、まだ消さないでください。


まとめ

  • コンポーネントは「見た目の部品」ではない。 「この見た目は、どのデータから決まるか」という対応関係のかたまり
  • 割る線は、見た目ではなくデータで引く。 「この状態は、他の部分が知らなくていい」と言えるところが線
  • text は TaskForm に下ろせて、tasks は下ろせなかった。 使っている人数が違うから
  • ファイルを分けること自体には価値が無い。 価値があるのは状態を隠せたときと2箇所以上で使うときだけ
  • props は関数の引数。 文字列・数値・オブジェクト・関数が渡せる。{} は「ここから JavaScript の式」の合図
  • 子は props を書き換えない。 書き換えてもエラーも出ず、画面も変わらず、あとで無関係な操作をしたときに突然反映される
  • データは親から子へ、報告は関数で子から親へ。 書き換える場所を親1箇所に固定すると、おかしくなったときに見る場所も1箇所で済む
  • 状態は「使う全員の、いちばん近い共通の親」に置く(リフトアップ)。子が自分のコピーを持つと、静かにずれる
  • useState(初期値) の初期値は、最初の1回しか使われない。 props をコピーしても追従しない
  • 計算で出せるものを状態にしない。 remaining は tasks から出せる。状態にした瞬間、一致させる責任が生まれる
  • 分けすぎると、<h1> を見るのに別ファイルを開くことになる。 1画面1コンポーネントで始めて、困ってから割る
  • 最初から正しく設計することはできない。 どの状態が誰に必要かは、機能を足してみるまで分からない
  • バケツリレーは、いずれ必ず起きる。 困ってから Context、それでも困ってからライブラリ。 順番を飛ばすとどれも分からない

参考リンク


次に読む

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

記事
← 前の記事手でDOMを書き換えるのをやめる — React・Vue・Svelte
→ 次の記事状態管理はライブラリの話ではない — Contextまで

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

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

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

Frontend›Writing Components
  • Components(props と状態)
  • State Management の入口(リフトアップ)

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

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

コメント

コメントする

目次