条件分岐の書き方 — 三項演算子が5段ネストした

条件分岐を読みやすく。整理した状態のカードとブラウザ画面、分岐を表す飾り。

そのあと、同じ画面に条件を足していきました。ログインしていない人には案内を出す。読み込み中はスピナーを出す。失敗したら再試行ボタン。0件なら「まだありません」。管理者にだけ削除ボタン。どれも1行ずつの、当たり前の要求です。

前回: リストのkey — 添字を使うとチェックがズレる

これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で 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 は「名前の無い穴」で、穴には名前を付けられること
  • isSmall isPrimary isDisabled のような真偽値の props が増えてきたら、それは分割の合図であること

この記事でやること

  1. ~/reactlab を新しく作る(本線の ~/react-demo は触らない)。ポートは 5188番
  2. 条件分岐の書き方4つを、同じ画面で1つずつ書いて見比べる。向き不向きを表にする
  3. 5段ネストの実物を書く。読めない状態を、自分の手で再現する
  4. 早期 return に直し、さらにコンポーネントへ切り出す。行数と「読み始めてから答えが分かるまでの行数」を before/after で比べる
  5. isLoading / error / data を status 1つにまとめ、switch で全部の場合を書く。わざと1つ消して、抜けに気づけることを確かめる
  6. children と名前付きの穴を持つ Card を書く。フラグ props で同じことをやろうとして、増え方を比べる
  7. ~/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の中で打ちます。

bash
$ cd ~
$ npm create vite@latest reactlab -- --template react

質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。

bash
$ cd ~/reactlab
$ npm install
$ ls
eslint.config.js  index.html  package.json  public  README.md  src  vite.config.js

この一覧が出れば成功です。 npm install は初回だけ数分かかります。何が起きているかはnpmの回、dist/ が何なのかはビルドツールの回にあります。

ポートを開ける

本線で 5173番を使っています。 ぶつからないように、この記事は 5188番でやります。

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

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

5188/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。原因を React 側に探しに行って、30分溶かしたことがあります。

起動する

bash
$ npm run dev -- --host 0.0.0.0 --port 5188

ホストの Windows のブラウザで http://192.168.226.50:5188/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。Vite のロゴとカウンターが出れば成功です。

止め方: ターミナルで Ctrl+C。この記事の間は起動したままで構いません。 保存するたびにブラウザが自動で更新されます。

[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5188 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5188 になっているのが見える形で。

置き場所を先に作る

この記事では、同じ画面を4回書き直します。 ファイルが混ざらないように、先に場所を決めます。

bash
$ mkdir -p ~/reactlab/src/steps
$ ls ~/reactlab/src
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択以上。 ネストした瞬間に読めなくなる
早期 returnif (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 を開いて、右側がどんどん深くなっているところを、並べて撮ってください。

何がまずいのか、数える

感想ではなく、数字で確かめます。

bash
$ wc -l ~/reactlab/src/steps/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. 「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 を並べる

bash
$ cd ~/reactlab/src/steps
$ wc -l BookListBad.jsx BookListGuard.jsx BookList.jsx BookRow.jsx
  41 BookListBad.jsx
  27 BookListGuard.jsx
  22 BookList.jsx
  12 BookRow.jsx
 102 合計

ここで「合計が増えている」ことに気づいてください。 41行が 34行(BookList + BookRow)になりました。ファイル数は増えました。

行数だけを見て「大して減っていない」と結論しないでください。 測るべきはこちらです。

測るものBadGuard切り出し後
最大ネスト段数522
未ログイン時の表示を知るのに読む行数3611
「1冊の見た目」を直すときに開くファイルの行数41(全部の条件を読まされる)2712
1つの関数の中の条件の数554 + 1

3行目がいちばん効きます。 「削除ボタンの文言を変えたい」だけの日に、読み込み中の分岐やエラー表示を読まされないのが、切り出しの本当の利益です。

行数は減らなくていい。 減らすのは1回に読む量です。


④ 状態の組み合わせを型で潰す

早期 return で読めるようになりました。それでも、まだ危ないところが残っています。

3つの真偽値は、8通りある

BookList が受け取っているのは isLoading / error / books の3つです。これらは互いに独立して渡せます。 ということは、呼び出し側は次のような組み合わせを作れてしまいます。

<BookList user={user} isLoading={true} error={new Error('失敗')} books={books} />

「読み込み中で、しかもエラーで、しかもデータもある」。現実には起こりえません。 それでも型の上では作れます。実際に App.jsx をこれに差し替えると、「読み込み中…」だけが出て、エラーは黙って消えます。

組み合わせを全部書き出すと、こうなります。

isLoadingerrordata実在するか
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。

ポートを閉じる

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

確認: 一覧に 5188/tcp が残っていなければ成功です。開けっぱなしにしないのは、Linux のファイアウォールの回でやったとおりです。

プロジェクトを消す

bash
$ rm -rf ~/reactlab
$ ls ~

確認: reactlab が消えて、react-demo が残っていれば片づけ完了です。

本線のタスクリストが動くことも確かめておきます。

bash
$ cd ~/react-demo
$ npm run dev -- --host 0.0.0.0 --port 5173

ブラウザで開いて、いつもの画面が出れば、何も壊していません。 確認したら 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通り。 status 1つにすると、間違った状態は書こうとしても書けない
  • switch + default: throw にすると、抜けが実行時に必ず落ちる。 黙って undefined を返す switch は、真っ白な画面を1時間見せる
  • 「実行前に気づく」に上げたくなったら TypeScript。 それが網羅性チェックを入れる動機
  • 分ける基準は4つ。名前が付くか・単独で理解できるか・2回以上出るか・100行を超えたか。 ①が最優先で、④はいちばん弱い
  • 分けすぎは、まとめすぎと同じくらい読みにくい。 判断は「その部品を、親を見ずに理解できるか」。できないなら切らない
  • props にフラグを足すより、中身を渡す。 children は名前の無い穴、header / footer は名前の付いた穴。props に React 要素を渡すだけで作れる
  • 真偽値の props が3つを超えたら、排他的なものを variant にまとめる。 まとめても if が5つ以上なら、それは別のコンポーネント
  • コンポーネントは必ずファイルの一番外側で定義する。 関数の中で定義すると、再描画のたびに作り直されて状態が消える

参考リンク


次に読む

この記事は 【深掘り】React の 12 / 24 本目です。

記事
← 前の記事リストのkey — 添字を使うとチェックがズレる
→ 次の記事データ取得とTanStack Query — 取得コードが200行になる

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

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

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

Frontend›React — Composition
  • 条件分岐の4つの書き方と早期return
  • status に畳む / children で合成する

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

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

コメント

コメントする

目次