そのあと、同じ画面に条件を足していきました。ログインしていない人には案内を出す。読み込み中はスピナーを出す。失敗したら再試行ボタン。0件なら「まだありません」。管理者にだけ削除ボタン。どれも1行ずつの、当たり前の要求です。
これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で props と状態まで進み、Reactの画面の回で「動くと使えるの差は4つの状態」をやった人が、画面に条件を足していくうちに、自分のコードが読めなくなったときに読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて VM(Ubuntu Server)の中で打ちます。 Windows の PowerShell ではありません。 プロンプトが
ユーザー名@ホスト名:~$になっていれば、Linux の中にいます。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った~/react-demo/には触りません。 この記事は~/reactlab/を新しく作り、ポート 5188番で動かします。最後に丸ごと消します。
以前、取得のコードを TanStack Query に任せて、短くしたことがあります(やり方は次の記事で扱います)。減ったのは「取得の世話」だけでした。
3日後、その画面のこの部分で手が止まりました。
{user ? (
isLoading ? <Spinner /> : (
error ? <p>失敗しました</p> : (
books.length > 0 ? (
<ul>{books.map((b) => (
<li key={b.id}>{b.title}{user.isAdmin && <button>削除</button>}</li>
))}</ul>
) : <p>まだありません</p>
)
)
) : <p>ログインしてください</p>}
これで全部です。 縦に長いだけで、やっていることは5つの条件しかありません。それなのに、
)がどの(に対応するのか、目で追えない- 「ログインしていない人に何が出るか」を知るには、いちばん下まで読まないと分からない
- 条件をもう1つ足すには、この塊のどこかを開いて、中に押し込むしかない
- エディタの自動整形をかけると、インデントがさらに深くなって余計に読めなくなる
ここで私は最初、「三項演算子を使うのをやめよう」と考えました。これは間違いでした。 三項演算子は悪くありません。5段ネストしているのが悪いのです。 そして5段ネストになった原因は、「1つのコンポーネントに5つの関心事を入れた」ことです。
この記事は、条件の書き方のテクニック集ではありません。 「どう書くか」の前に「どこで切るか」を決める記事です。切る場所さえ決まれば、条件の書き方は4つしかなく、それぞれ向き不向きがはっきりしています。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- 条件分岐の書き方は4つしかないこと(
&&/ 三項 / 早期return/ 変数に入れる)。多いから迷うのではなく、使い分けを決めていないから迷うこと &&は「出す・出さない」、三項は「AかB」であり、この2つを混ぜると読めなくなること。&&の右に「else 相当」を書き足したくなったら、それは三項に変える合図であること- ネストが深いのは書き方の問題ではなく、コンポーネントの切り方の問題であること。早期
returnはネストを「縦」に開くこと isLoading/error/dataを別々の真偽値で持つと、あり得ない組み合わせが作れてしまうこと。8通りのうち、実在するのは4通りしかないこと- 状態を
statusという1つの値にすると、switchで「全部の場合を書いたか」を目で確認できること。抜けはdefaultが教えてくれること - コンポーネントを分ける基準は4つあり、「分けすぎ」も同じくらい読みにくいこと。ファイルを行き来する時間は、コードを読む時間に入ること
- props にフラグを足し続けるより、中身そのものを渡すほうが早いこと(合成)。
childrenは「名前の無い穴」で、穴には名前を付けられること isSmallisPrimaryisDisabledのような真偽値の props が増えてきたら、それは分割の合図であること
この記事でやること
~/reactlabを新しく作る(本線の~/react-demoは触らない)。ポートは 5188番- 条件分岐の書き方4つを、同じ画面で1つずつ書いて見比べる。向き不向きを表にする
- 5段ネストの実物を書く。読めない状態を、自分の手で再現する
- 早期
returnに直し、さらにコンポーネントへ切り出す。行数と「読み始めてから答えが分かるまでの行数」を before/after で比べる isLoading/error/dataをstatus1つにまとめ、switchで全部の場合を書く。わざと1つ消して、抜けに気づけることを確かめるchildrenと名前付きの穴を持つCardを書く。フラグ props で同じことをやろうとして、増え方を比べる~/reactlabを消して、~/react-demoが無事なことを確かめる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 早期 return(early return) | 条件に当てはまったら、その場で return して先を読ませない書き方。 残りのコードは「その条件を通過した場合」だけを考えればよくなる |
| ガード節 | 早期 return のうち、関数の先頭に並べる「まず弾く」ためのもの。「番人」の意味 |
| 合成(composition) | 部品の中身を、外から渡して組み立てること。 「継承」の反対語として使われる。React が公式に勧めている組み立て方 |
children | 開始タグと終了タグの間に書いたものが、そのまま入ってくる props。 名前の無い穴 |
| スロット | 「ここに何か入れてください」という穴のこと。 React に専用の機能はなく、props に React 要素を渡すだけで作れる |
| 判別可能なユニオン | 「どれか1つ」を表す値の持ち方。 'idle' / 'loading' / 'success' / 'error' のように、取りうる値を並べて書く |
| 網羅性チェック | 場合分けに抜けが無いかを、機械に確かめさせること。 switch の default と TypeScript を組み合わせると効く |
| props ドリリング | 使いたい場所まで、props を何段も手渡しで下ろすこと。 合成で減らせることがある |
① 準備 — reactlab を新しく作る
本線で作った ~/react-demo/ は、そのまま残します。 この記事はわざと読めないコードを書く手順を含むので、新しいプロジェクトでやります。
VMの中で打ちます。
質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。
eslint.config.js index.html package.json public README.md src vite.config.js
この一覧が出れば成功です。 npm install は初回だけ数分かかります。何が起きているかはnpmの回、dist/ が何なのかはビルドツールの回にあります。
ポートを開ける
本線で 5173番を使っています。 ぶつからないように、この記事は 5188番でやります。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5188/tcp ALLOW Anywhere
5188/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。原因を React 側に探しに行って、30分溶かしたことがあります。
起動する
ホストの Windows のブラウザで http://192.168.226.50:5188/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。Vite のロゴとカウンターが出れば成功です。
止め方: ターミナルで Ctrl+C。この記事の間は起動したままで構いません。 保存するたびにブラウザが自動で更新されます。
[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5188 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5188 になっているのが見える形で。
置き場所を先に作る
この記事では、同じ画面を4回書き直します。 ファイルが混ざらないように、先に場所を決めます。
App.css App.jsx assets index.css main.jsx steps
steps が出れば成功です。
② 条件分岐の書き方は4つしかない
まず全体像です。 JSX の中で条件を扱う書き方は、この4つで打ち止めです。他は組み合わせでしかありません。
理由はJSXの回でやったとおりで、{} の中に書けるのは式だけだからです。if は文なので、そもそも JSX の {} に入りません。 入れられるのは「値になるもの」だけで、値になる条件の書き方は限られています。
4つを、同じ内容で書き並べる
~/reactlab/src/steps/Four.jsx を新しく作ります。VS Code から VM を開いて編集しても、VM の中で nano を使っても構いません。
export default function Four({ user, count }) {
// ③ 早期 return(ガード節)
if (!user) return <p>ログインしてください</p>;
// ④ 変数に入れる
let badge;
if (count > 100) badge = <span>常連</span>;
else if (count > 0) badge = <span>{count}件</span>;
else badge = null;
return (
<div>
{/* ① && — 出す・出さない */}
{user.isAdmin && <button>削除</button>}
{/* ② 三項 — AかB */}
<p>{count > 0 ? `${count}件あります` : 'まだありません'}</p>
{badge}
</div>
);
}
~/reactlab/src/App.jsx を、次の内容にまるごと置き換えて表示します。
import Four from './steps/Four';
export default function App() {
const user = { name: 'senbo', isAdmin: true };
return <Four user={user} count={3} />;
}
保存すると、ブラウザに 削除ボタン・「3件あります」・「3件」 が出ます。出れば成功です。App.jsx の user を null に変えると、「ログインしてください」だけになります。早期 return の下は、一切実行されていません。
向き不向きの表
この表がこの記事の背骨です。 迷ったらここに戻ります。
| 書き方 | 形 | 向いている場面 | 向かない場面 |
|---|---|---|---|
&& | {cond && <A />} | 出す・出さないの1択。 権限による追加ボタン、警告の1行 | 「無いときに別のものを出す」。 ここで && を2つ並べると、条件が重複して破綻する |
| 三項 | {cond ? <A /> : <B />} | AかBの2択。 「編集中/表示中」のように、どちらかが必ず出るもの | 3択以上。 ネストした瞬間に読めなくなる |
早期 return | if (cond) return <A />; | 画面まるごとが入れ替わる場合。 読み込み中・エラー・未ログイン | 画面の一部分だけを出し分けたいとき(return は関数を抜けてしまう) |
| 変数に入れる | let x; if (…) x = <A />; | 条件が複雑で、JSX の中に書くと縦に伸びるとき。 名前を付けられるのが利点 | 単純な1条件。 わざわざ変数にすると、かえって目線が往復する |
&& と三項を混ぜない
この記事でいちばん守ってほしい約束です。
&&は「表示する/しない」だけに使う- 三項は「AかB」だけに使う
混ぜると、こうなります。
{/* だめな例 — && の右に、さらに三項が入っている */}
{user && (user.isAdmin ? <AdminPanel /> : <UserPanel />)}
これは動きますが、読む人は「この行は1つのことをしているのか、2つなのか」を毎回判断させられます。 条件が2つあるなら、行を2つに分けるか、コンポーネントを分けるほうが速く読めます。
{/* 分ける */}
{!user && <p>ログインしてください</p>}
{user && <Panel isAdmin={user.isAdmin} />}
&& の左に数値を置かない
&& を使うときの唯一の落とし穴です。JSXの回で、変換後のコードから理由を確かめました。
{books.length && <p>本があります</p>}
books が空のとき、画面に 0 が出ます。&& は真偽値を返すのではなく、左の値をそのまま返すからです。そして React は false / null / undefined は描きませんが、0 は描きます。
対策は、必ず真偽値にすること。
{books.length > 0 && <p>本があります</p>}
「&& の左に .length を書いたら > 0 を付ける」と、指の癖にしてしまうのがいちばん確実です。
③ 5段ネストを解く
ここからが本題です。 冒頭のコードを、実際に自分の手で書きます。読めない状態を、目の前に置いてから直します。
読めないコードを、まず書く
~/reactlab/src/steps/BookListBad.jsx を作ります。
export default function BookListBad({ user, isLoading, error, books }) {
return (
<div>
<h2>本の一覧</h2>
{user ? (
isLoading ? (
<p>読み込み中…</p>
) : (
error ? (
<div>
<p>失敗しました: {error.message}</p>
<button>再試行</button>
</div>
) : (
books.length > 0 ? (
<ul>
{books.map((b) => (
<li key={b.id}>
{b.title}
{user.isAdmin ? (
b.locked ? (
<span>(保護)</span>
) : (
<button>削除</button>
)
) : null}
</li>
))}
</ul>
) : (
<p>まだ1冊もありません</p>
)
)
)
) : (
<p>ログインしてください</p>
)}
</div>
);
}
App.jsx を差し替えて表示します。
import BookListBad from './steps/BookListBad';
const books = [
{ id: 1, title: '達人プログラマー', locked: false },
{ id: 2, title: 'リーダブルコード', locked: true },
];
export default function App() {
return (
<BookListBad
user={{ name: 'senbo', isAdmin: true }}
isLoading={false}
error={null}
books={books}
/>
);
}
画面には正しく一覧が出ます。 ここが厄介なところで、このコードは動きます。 動くので、直す理由が自分では見つけにくい。
[スクリーンショット: 02_5段ネストの画面.png] ブラウザに一覧が正しく出ているところと、エディタで BookListBad.jsx を開いて、右側がどんどん深くなっているところを、並べて撮ってください。
何がまずいのか、数える
感想ではなく、数字で確かめます。
41 ~/reactlab/src/steps/BookListBad.jsx
41行。長すぎるわけではありません。 問題は行数ではなく、次の3つです。
| 測るもの | この版 | なぜ問題か |
|---|---|---|
| 最大ネスト段数 | 5段 | 人が括弧の対応を目で追えるのは、だいたい2〜3段まで |
| 「未ログインだと何が出るか」を知るのに読む行数 | 36行(先頭から ) : ( の下まで) | いちばん単純な答えが、いちばん下にある |
| 条件を1つ足すときに触る場所 | 既存の塊の内側 | 他の条件のインデントが全部ずれる。 差分が読めなくなる |
3つ目が本当の被害です。 「管理者かつ在庫あり」をあとで足そうとすると、関係ない行まで差分に出ます。 レビューできません。
直し方その1 — 早期 return に開く
ネストは「横」に深くなります。早期 return は、それを「縦」に開きます。
~/reactlab/src/steps/BookListGuard.jsx を作ります。
export default function BookListGuard({ user, isLoading, error, books }) {
if (!user) return <p>ログインしてください</p>;
if (isLoading) return <p>読み込み中…</p>;
if (error) {
return (
<div>
<p>失敗しました: {error.message}</p>
<button>再試行</button>
</div>
);
}
if (books.length === 0) return <p>まだ1冊もありません</p>;
return (
<ul>
{books.map((b) => (
<li key={b.id}>
{b.title}
{user.isAdmin && (b.locked ? <span>(保護)</span> : <button>削除</button>)}
</li>
))}
</ul>
);
}
App.jsx の import を BookListGuard に変えて表示すると、さっきと寸分違わぬ画面が出ます。見た目が変わらないことを必ず確かめてください。 ここで画面が変わるなら、条件の順番を写し間違えています。
何が変わったか。
- 上から5行読めば、「出ない条件」が全部分かる。 一覧が出る条件は「その5つを全部通過したとき」
- 最後の
returnは、userがあって、読み込みが終わっていて、エラーが無くて、1冊以上ある場合しか考えなくてよい - 条件を足すのは、
ifを1行足すだけ。 差分が1行で済む
ただし、早期 return にも順番があります。 if (books.length === 0) を if (isLoading) より上に書くと、読み込み中に「まだ1冊もありません」が一瞬出ます。 データが来る前は books が空だからです。「まだ分からない」を「無い」と表示してしまうのは、実際に本番でよくやる事故です。
順番の原則は「不確かなものから先に弾く」です。未ログイン → 読み込み中 → エラー → 空 → 本体。
直し方その2 — コンポーネントに切り出す
早期 return で読めるようにはなりました。ただし、まだ2つの関心事が同居しています。
- 「どの状態の画面を出すか」(未ログイン・読み込み中・エラー・空・一覧)
- 「1冊をどう描くか」(タイトル・管理者なら削除ボタン・保護なら印)
2つ目を切り出します。 ~/reactlab/src/steps/BookRow.jsx を作ります。
function AdminAction({ locked }) {
if (locked) return <span>(保護)</span>;
return <button>削除</button>;
}
export default function BookRow({ book, isAdmin }) {
return (
<li>
{book.title}
{isAdmin && <AdminAction locked={book.locked} />}
</li>
);
}
~/reactlab/src/steps/BookList.jsx を作ります。
import BookRow from './BookRow';
export default function BookList({ user, isLoading, error, books }) {
if (!user) return <p>ログインしてください</p>;
if (isLoading) return <p>読み込み中…</p>;
if (error) {
return (
<div>
<p>失敗しました: {error.message}</p>
<button>再試行</button>
</div>
);
}
if (books.length === 0) return <p>まだ1冊もありません</p>;
return (
<ul>
{books.map((b) => (
<BookRow key={b.id} book={b} isAdmin={user.isAdmin} />
))}
</ul>
);
}
key は BookRow ではなく、map が返す一番外側に付けます。 中に付けても効きません(keyの回でやりました)。
App.jsx を BookList に差し替えて、画面が変わっていないことを確かめます。
[スクリーンショット: 03_切り出し後の画面.png] BookList に差し替えたあとの画面と、エディタで BookList.jsx を開いて、インデントが2段までしか無いところを撮ってください。
before / after を並べる
41 BookListBad.jsx
27 BookListGuard.jsx
22 BookList.jsx
12 BookRow.jsx
102 合計
ここで「合計が増えている」ことに気づいてください。 41行が 34行(BookList + BookRow)になりました。ファイル数は増えました。
行数だけを見て「大して減っていない」と結論しないでください。 測るべきはこちらです。
| 測るもの | Bad | Guard | 切り出し後 |
|---|---|---|---|
| 最大ネスト段数 | 5 | 2 | 2 |
| 未ログイン時の表示を知るのに読む行数 | 36 | 1 | 1 |
| 「1冊の見た目」を直すときに開くファイルの行数 | 41(全部の条件を読まされる) | 27 | 12 |
| 1つの関数の中の条件の数 | 5 | 5 | 4 + 1 |
3行目がいちばん効きます。 「削除ボタンの文言を変えたい」だけの日に、読み込み中の分岐やエラー表示を読まされないのが、切り出しの本当の利益です。
行数は減らなくていい。 減らすのは1回に読む量です。
④ 状態の組み合わせを型で潰す
早期 return で読めるようになりました。それでも、まだ危ないところが残っています。
3つの真偽値は、8通りある
BookList が受け取っているのは isLoading / error / books の3つです。これらは互いに独立して渡せます。 ということは、呼び出し側は次のような組み合わせを作れてしまいます。
<BookList user={user} isLoading={true} error={new Error('失敗')} books={books} />
「読み込み中で、しかもエラーで、しかもデータもある」。現実には起こりえません。 それでも型の上では作れます。実際に App.jsx をこれに差し替えると、「読み込み中…」だけが出て、エラーは黙って消えます。
組み合わせを全部書き出すと、こうなります。
| isLoading | error | data | 実在するか |
|---|---|---|---|
| false | なし | なし | する(まだ何も始めていない) |
| true | なし | なし | する(読み込み中) |
| false | なし | あり | する(成功) |
| false | あり | なし | する(失敗) |
| true | あり | なし | しない |
| true | なし | あり | しない(※再取得中は例外。後述) |
| true | あり | あり | しない |
| false | あり | あり | しない(※古いデータを残す設計なら例外) |
8通りのうち、素直に実在するのは4通りだけです。残りの4通りは、バグとしてしか発生しません。 そして「発生しないはず」のものは、発生したときに誰も気づきません。
状態の持ち方そのもの(
useStateを3つ持つかuseReducerにまとめるか)は、useStateとuseReducerの回で扱いました。 この記事は表示側に絞ります。 つまり、「渡ってきた状態を、画面としてどう場合分けするか」だけを考えます。
status という1つの値にする
やることは単純です。3つの独立した値を、1つの値にします。
// 前 — 3つが独立している(8通り作れる)
{ isLoading: false, error: null, books: [] }
// 後 — 1つしかない(4通りしか作れない)
{ status: 'success', books: [] }
status が取りうる値は 'idle' / 'loading' / 'success' / 'error' の4つだけです。この4つは同時に成り立ちません。 1つの変数に入っているので、「読み込み中かつエラー」という状態は、書こうとしても書けません。
これが「型で潰す」ということです。 チェックを増やすのではなく、間違った状態を表現できなくします。
switch で全部の場合を書く
~/reactlab/src/steps/BookListStatus.jsx を作ります。
import BookRow from './BookRow';
export default function BookListStatus({ status, books, error, isAdmin }) {
switch (status) {
case 'idle':
return <p>キーワードを入れて検索してください</p>;
case 'loading':
return <p>読み込み中…</p>;
case 'error':
return (
<div>
<p>失敗しました: {error.message}</p>
<button>再試行</button>
</div>
);
case 'success':
if (books.length === 0) return <p>まだ1冊もありません</p>;
return (
<ul>
{books.map((b) => (
<BookRow key={b.id} book={b} isAdmin={isAdmin} />
))}
</ul>
);
default:
throw new Error(`未知の status: ${status}`);
}
}
App.jsx を差し替えて、status を4つとも試します。
import BookListStatus from './steps/BookListStatus';
const books = [
{ id: 1, title: '達人プログラマー', locked: false },
{ id: 2, title: 'リーダブルコード', locked: true },
];
export default function App() {
// ここを 'idle' / 'loading' / 'success' / 'error' に手で書き換えて確かめる
const status = 'success';
return (
<BookListStatus
status={status}
books={books}
error={new Error('通信できません')}
isAdmin={true}
/>
);
}
4つとも、想定どおりの画面が出れば成功です。
[スクリーンショット: 04_4つのstatus.png] status を4つ順に書き換えて、4つの画面が出ているところを撮ってください。1枚に並べても、4枚に分けても構いません。
抜けに気づけることを、わざと確かめる
switch にした本当の利点は、ここです。 case 'error': の塊をまるごと消してから、App.jsx の status を 'error' にしてください。
Uncaught Error: 未知の status: error
画面が真っ白になり、はっきり落ちます。 これは失敗ではなく、成功です。
もし default が無く、switch が黙って undefined を返していたら、画面には何も出ないだけでした。「通信が失敗したときに、エラーも何も出ない画面」は、気づくまでに数週間かかります。 早く、うるさく落ちるほうが安全です。
確かめたら、消した case 'error': を元に戻してください。
defaultに何を書くかは、方針で分かれます。
・throwする — 開発中に必ず気づく。この記事はこちら
・return null— 何も出さない。落としたくない画面向け
・エラー用の表示を返す — 本番向けどれを選ぶにせよ、
defaultを書かないという選択肢はありません。 書かないと「抜けている」と「わざと何もしない」が区別できなくなります。
TypeScript を入れると、機械が数えてくれる
いまの switch は、「4つ書いたつもり」が合っているかを、人が目で確かめています。 これを機械にやらせるのが、TypeScript です。
type Status = 'idle' | 'loading' | 'success' | 'error';
こう書いておくと、case が1つでも足りないと、実行する前に赤線が出ます。 これが網羅性チェックです。
この記事では入れません。 入れなくても switch + default で「実行時に必ず気づく」ところまでは行けるからです。「実行前に気づく」に上げたくなったときが、TypeScript を入れる動機になります。
4状態で足りない場合がある
表の中に「※」を付けた行がありました。「読み込み中で、しかもデータがある」という状態です。
再取得のときに、実際に起こります。 検索結果を出したあと、次のキーワードで検索する間、古い結果を薄く表示したまま待つ、という作りは普通にあります。
このときは、status を増やすのではなく、別の値を1つ足します。
{ status: 'success', books: [...], isRefetching: true }
'loading' と 'refetching' を並べる手もありますが、case が増えて表示が重複します。 「画面まるごとが入れ替わるか」で分けるのが基準です。初回は入れ替わるので status、再取得は入れ替わらないので別の値。
この区別は次回の TanStack Query の回で使うライブラリがそのまま持っています。 ライブラリが status と「再取得中か」を別々に返してくるのは、まさにこの理由です。自分で書いてから見ると、あの API が「そう作ってある」ことが分かります。
⑤ コンポーネントを分ける基準
「切り出す」と言ってきましたが、どこで切るのかを決めていませんでした。ここを言語化します。
4つの基準
1つでも当てはまれば、切り出す候補です。
| 基準 | 判定のしかた | 例 |
|---|---|---|
| ① 名前が付くか | その塊を、10秒以内に短い名前で呼べるか。 呼べないなら、まだ1つの部品になっていない | BookRow EmptyState RetryPanel |
| ② 独立してテストできるか | 「この props を渡したら、この見た目になる」と1行で言えるか。 言えるなら切れる | <BookRow book={…} isAdmin={false} /> |
| ③ 2回以上出てくるか | 同じ形が2箇所以上にあるか。 3回目を書く前に切る | 空表示、エラー表示、バッジ |
| ④ 100行を超えたか | 1画面(だいたい50行)に収まらず、スクロールしないと全体が見えないか | 何でも入っている App.jsx |
①が最優先です。 名前が付かない塊を無理に切り出すと、Section1 Wrapper2 ContentInner のような中身を説明しない名前が並びます。名前が付かないのは、まだ関心事が混ざっているサインなので、切る場所が違います。
④は、いちばん弱い基準
行数だけを理由に切らないでください。 120行あっても、上から下に素直に読める1つの流れなら、切ると読みにくくなります。
行数は「見に行く合図」であって、「切る理由」ではありません。 100行を超えたら、①〜③に当てはまるものが無いか探す。無ければ、そのままで構いません。
分けすぎも、同じくらい読みにくい
これは実際にやりました。 「小さいほうがいい」と思って、こう分けました。
src/components/
├── BookList.jsx
├── BookListItem.jsx
├── BookListItemTitle.jsx
├── BookListItemActions.jsx
├── BookListItemDeleteButton.jsx
├── BookListEmpty.jsx
└── BookListError.jsx
1冊のタイトルの色を変えるのに、5ファイル開きました。
BookListItemTitle.jsxは、中身が3行でした。開く手間のほうが、読む手間より大きい- props が親から子へ、4段も手渡しされていました(props ドリリング)。1つ足すと4ファイル直します
- 「削除ボタンはどこから呼ばれているか」を追うのに、逆向きに5ファイル辿りました
分けすぎのコストは、「ファイルを行き来する時間」です。 そしてこれは、コードを読む時間に含まれます。 行数を減らしても、読む時間が増えたら意味がありません。
判断は単純にしています。
「その部品を、親を見ずに理解できるか」。できないなら、切らずに親に置いたままにする。
BookListItemTitle は、親(BookListItem)を見ないと何のタイトルか分かりません。 だから切るべきではありませんでした。BookRow は、book と isAdmin を渡せば単独で意味が分かるので、切ってよかったのです。
これが基準②「独立してテストできるか」の言い換えです。
⑥ 合成 — children と、名前付きの穴
分ける話の裏側が、組み立てる話です。
props にフラグを足していく道
こういう Card を作ったとします。
// 最初
function Card({ title, body }) {
return (
<div className="card">
<h3>{title}</h3>
<p>{body}</p>
</div>
);
}
要望が来ます。 「閉じるボタンを付けたい」「タイトルの横にバッジを出したい」「下にボタンを2つ並べたい」「本文の代わりに一覧を出したい」。
props を足していくと、こうなります。
function Card({
title, body, showClose, onClose, badgeText, badgeColor,
footerButtons, useListBody, listItems, hideHeader,
}) {
// 中で if が10個
}
破綻しています。 Card は「カードの見た目」を持つはずだったのに、中に入るものすべてを知っている必要が出てきました。要望が来るたびに Card を開いて直すことになります。
中身を渡す — children
children は、開始タグと終了タグの間に書いたものが、そのまま入ってくる props です。 特別な仕組みではなく、ただの props の1つです(JSXの回で変換後を見ました)。
~/reactlab/src/steps/Card.jsx を作ります。
export default function Card({ header, footer, children }) {
return (
<section style={{ border: '1px solid #ccc', padding: 12, margin: 12 }}>
{header && <div style={{ borderBottom: '1px solid #eee' }}>{header}</div>}
<div>{children}</div>
{footer && <div style={{ borderTop: '1px solid #eee' }}>{footer}</div>}
</section>
);
}
props は3つしかありません。 それでも、さっきの要望は全部通ります。
import Card from './steps/Card';
import BookRow from './steps/BookRow';
const books = [
{ id: 1, title: '達人プログラマー', locked: false },
{ id: 2, title: 'リーダブルコード', locked: true },
];
export default function App() {
return (
<Card
header={
<h3>
本の一覧 <span>(新着)</span> <button>×</button>
</h3>
}
footer={
<>
<button>追加</button>
<button>並べ替え</button>
</>
}
>
<ul>
{books.map((b) => (
<BookRow key={b.id} book={b} isAdmin={true} />
))}
</ul>
</Card>
);
}
枠の中に、ヘッダ・一覧・フッタが並べば成功です。
[スクリーンショット: 05_Cardの合成.png] Card で組み立てたカードが表示されているところを撮ってください。
何が起きたか
| フラグを増やす | 中身を渡す(合成) | |
|---|---|---|
| 要望が1つ来たとき | Card を開いて直す | Card は触らない。 呼ぶ側だけ変わる |
| props の数 | 要望の数だけ増える | 3つのまま |
Card が知っていること | 中に入るもの全部 | 「枠と、3つの穴がある」だけ |
| 中身の入れ替え | 新しいフラグが要る | その場で書ける |
children は「名前の無い穴」、header と footer は「名前の付いた穴」です。React には「スロット」という専用の機能はありません。props に React 要素を渡しているだけです。それだけで足ります。
使い分けの目安
- 穴が1つなら
children。 名前を付ける必要がありません - 穴が2つ以上なら、名前を付ける。
childrenを配列で受けて「1つ目がヘッダ、2つ目が本文」とするのは、呼ぶ側が順番を暗記させられるのでやりません - 穴が5つを超えたら、それは
Cardではありません。 そのレイアウト専用のコンポーネントとして、別の名前を付けます
⑦ フラグ props が増えたら、分割の合図
⑥は「中身」の話でした。ここは「見た目」の話です。
増え方の実例
ボタンを1つ作ります。
<Button isPrimary />
<Button isPrimary isSmall />
<Button isPrimary isSmall isDisabled />
<Button isPrimary isSmall isDisabled isLoading />
<Button isDanger isSmall isLoading isFullWidth />
真偽値の props が5つになりました。 ここで、組み合わせの数を数えてください。
2の5乗 = 32通りです。そのうち、実際に使うのは10通りくらいでしょう。残りは、
isPrimaryとisDangerを同時に渡したら、どちらが勝つのか(Buttonの中のifの順番で決まる。書いた人しか知らない)isDisabledとisLoadingを同時に渡したら、押せないうえに回るのかisSmallとisFullWidthは両立するのか
どれも、Button の中を読まないと分かりません。 そして Button の中は、フラグの組み合わせを捌く if でいっぱいになります。
畳み方1 — 排他的なフラグは、1つの値にまとめる
④でやったことと同じです。 「同時に成り立たないもの」は、1つの変数に入れます。
// 前 — 同時に渡せてしまう
<Button isPrimary isDanger />
// 後 — 1つしか選べない
<Button variant="primary" />
<Button variant="danger" />
<Button variant="ghost" />
size も同じです。isSmall isLarge の2つではなく、size="sm" | "md" | "lg" の1つにします。
判定のしかたは「同時に true にして意味があるか」です。意味が無いなら、まとめる。 意味があるなら、別々のままでよい(isDisabled と isLoading は、実は同時に意味があります)。
畳み方2 — 見た目が別物なら、別のコンポーネントにする
フラグを全部まとめても、まだ if が多いなら、それは1つの部品ではありません。
// 中で if が10個ある Button
<Button variant="icon" iconOnly ariaLabel="閉じる" />
// 別の部品にする
<IconButton icon="×" label="閉じる" />
「アイコンだけのボタン」は、テキストのボタンとは別物です。中身の構造も、読み上げのためのラベルが必須という条件も違います(アクセシビリティの回)。同じ Button に押し込むから if が増えます。
合図の数え方
私が使っている、単純な数え方です。
| 数えるもの | 閾値 | 超えたら |
|---|---|---|
| 真偽値の props の数 | 3つ | 排他的なものが無いか探す → variant にまとめる |
まとめたあとの if の数 | 5つ | 別のコンポーネントに割る |
| props の合計 | 7つ | 「渡しすぎ」。合成で中身を渡せないかを考える |
厳密な数字ではありません。 大事なのは、「増えてきたな」という感覚ではなく、数えて判断することです。感覚だと、書いた本人には最後まで気づけません。
「同じボタンが3種類できてしまう」という、逆方向の問題もあります。そちらはデザインシステムの回にあります。分けすぎと、まとめすぎは、同じ表の裏表です。
つまずいたところ
早期 return の順番を間違えて、一瞬「0件」が出た
③で書いたとおりのことを、実際にやりました。 if (books.length === 0) を上に書いていて、画面を開くたびに「まだ1冊もありません」が一瞬光って、そのあと一覧が出るという動きになりました。
バグだと気づくのに時間がかかりました。 最終的には正しい画面が出るからです。「なんかチカチカするな」で3日過ごしました。
原因は、books の初期値が [] だったことです。「まだ来ていない」と「無い」が、同じ [] で表現されていました。 ④の status にすると、この2つは 'loading' と 'success' に分かれるので、構造的に起こらなくなります。
&& の右を null にして、意味が分からなくなった
{cond && <A />} の「else 側」を書きたくなって、こう書きました。
{user.isAdmin ? <button>削除</button> : null}
動きますが、: null は情報がゼロです。 「何も出さない」を明示したつもりでしたが、読む人には 「三項があるから、2択なんだな」と読めてしまいます。実際は1択です。
: null になったら、&& に書き換える。 これで「これは出す・出さないだ」と一目で分かります。②の約束はここから来ています。
switch の case に {} を付けずに、変数の宣言でエラー
case の中で const を宣言したら、ESLint(Vite のテンプレートに入っている推奨設定の no-case-declarations ルール)にこう指摘されました。
Unexpected lexical declaration in case block
JavaScript としては動きますが、case は独立したブロックではないので、宣言がほかの case からも見えてしまいます。それを止めるルールです。宣言したいときは、その case を {} で囲みます。
case 'success': {
const sorted = [...books].sort();
return <ul>…</ul>;
}
今回はこれを避けるために、case の中では宣言しない書き方にしました。 宣言が要るほど処理が長いなら、それはコンポーネントに切り出す合図でもあります。
コンポーネントを App.jsx の中で定義して、入力が消えた
App.jsx の中に、こう書きました。
export default function App() {
function Row({ book }) { return <li>{book.title}</li>; } // だめ
return <ul>…</ul>;
}
動きます。 ただし、App が再描画されるたびに Row は「別の関数」として作り直されます。React から見ると毎回違うコンポーネントなので、中の状態も入力欄の中身も全部消えます。
理由は再描画の回とkeyの回でやったことと同じです。React は「同じ場所に同じものがあるか」で作り直すかを決めていて、関数の実体が変わると別物と判定されます。
コンポーネントは、必ずファイルの一番外側で定義します。
「小さく分ける」を信じすぎて、7ファイルにした
⑤に書いたとおりです。戻すのに、切り出したときの3倍の時間がかかりました。 分けるのは足し算ですが、戻すのは、どこに何があるかを全部思い出す作業です。
教訓は「迷ったら切らない」です。切らずに困ったら、そのときに切ればいい。 逆は高くつきます。
default: を書かずに、真っ白な画面を1時間見た
switch に default を書かず、status に 'succeeded'('success' の打ち間違い)を渡していました。エラーも警告も出ません。 switch は何も返さず、React は undefined を「何も描かない」として黙って処理しました。
開発者ツールにも何も出ません。 「データは来ているのに画面が空」を、通信の問題だと思い込んで1時間探しました。
default: throw を書いていれば、5秒で分かりました。
後片づけ
開発サーバーを止める
起動しているターミナルで Ctrl+C。
ポートを閉じる
確認: 一覧に 5188/tcp が残っていなければ成功です。開けっぱなしにしないのは、Linux のファイアウォールの回でやったとおりです。
プロジェクトを消す
確認: reactlab が消えて、react-demo が残っていれば片づけ完了です。
本線のタスクリストが動くことも確かめておきます。
ブラウザで開いて、いつもの画面が出れば、何も壊していません。 確認したら Ctrl+C で止めます。
戻し方: もう一度試したくなったら、①の
npm create vite@latest reactlab -- --template reactからやるだけです。数分で戻せます(node_modulesは消してよい)。
まとめ
- 条件分岐の書き方は4つしかない。
&&/ 三項 / 早期return/ 変数に入れる。{}にifが書けないのは React の制限ではなく、{}に入るのが式だけだから &&は「出す・出さない」、三項は「AかB」。混ぜない。&&の右に else 相当を足したくなったら三項へ、三項の: nullが出てきたら&&へ&&の左に.lengthを書いたら> 0を付ける。&&は左の値をそのまま返し、React は0を描く- ネストが深いのは書き方の問題ではなく、切り方の問題。 早期
returnは横のネストを縦に開く。5段が2段になった - 早期
returnの順番は「不確かなものから先に弾く」。 空判定を読み込み中より上に書くと、「まだ分からない」が「無い」として一瞬表示される - 行数は減らなくていい。減らすのは1回に読む量。 切り出しの利益は「未ログインの表示を知るのに36行読んでいたのが1行になる」こと
isLoading/error/dataを別々に持つと8通り作れて、実在するのは4通り。status1つにすると、間違った状態は書こうとしても書けないswitch+default: throwにすると、抜けが実行時に必ず落ちる。 黙ってundefinedを返すswitchは、真っ白な画面を1時間見せる- 「実行前に気づく」に上げたくなったら TypeScript。 それが網羅性チェックを入れる動機
- 分ける基準は4つ。名前が付くか・単独で理解できるか・2回以上出るか・100行を超えたか。 ①が最優先で、④はいちばん弱い
- 分けすぎは、まとめすぎと同じくらい読みにくい。 判断は「その部品を、親を見ずに理解できるか」。できないなら切らない
- props にフラグを足すより、中身を渡す。
childrenは名前の無い穴、header/footerは名前の付いた穴。props に React 要素を渡すだけで作れる - 真偽値の props が3つを超えたら、排他的なものを
variantにまとめる。 まとめてもifが5つ以上なら、それは別のコンポーネント - コンポーネントは必ずファイルの一番外側で定義する。 関数の中で定義すると、再描画のたびに作り直されて状態が消える
参考リンク
- roadmap.sh — React
- React 公式 — 条件付きレンダー
- React 公式 — コンポーネントのインポートとエクスポート
- React 公式 — props をコンポーネントに渡す
- React 公式 — state の構造の選択
- React 公式 — UI をツリーとして理解する
- React 公式 — state の保持とリセット
- React 公式 — Fragment
- MDN — 条件 (三項) 演算子
- MDN — 論理積 (&&)
- MDN — switch
- TypeScript ハンドブック — Narrowing
- Vite 公式ガイド
次に読む
この記事は 【深掘り】React の 12 / 24 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- 条件分岐の4つの書き方と早期return
- status に畳む / children で合成する
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント