「モード」をコンポーネントに持たせない理由
Life Atelierで、編集画面用のコンポーネントを閲覧専用画面でも使い回すために、モードフラグを足す案をやめ、呼び出し元が部品を選ぶ構造へ組み替えた。
① やったこと
Before: 編集画面用に作った参照軸の表示部品に、閲覧専用画面でも使うため「編集可能かどうか」を示す真偽値プロパティを足そうとしていた。部品の内側で、編集ボタンや編集パネルの出し分けを分岐する。
// 変更前の案:モードフラグで内部分岐する
export function AxesScale({ axes, readOnly }: AxesScaleProps) {
const [dock, setDock] = useState<DockState>({ kind: 'closed' });
return (
<div>
{!readOnly && <AddAxisButton onTap={() => setDock({ kind: 'add' })} />}
{!readOnly && dock.kind !== 'closed' && <AxisEditPanel dock={dock} />}
<AxisTicks axes={axes} />
</div>
);
}Life Atelierは、専用の記法で書いたテキスト(スクリプト)を、人生の出来事とその依存関係のグラフとして描画するツールである。新しく追加したショーケースは、他人が書いた完成形を読み取り専用で見せる入口であり、実際に自分で編集するアトリエと同じ見た目でなければ意味がない。そのため部品を流用したいが、そのままでは閲覧専用画面からも編集操作が現れてしまう。

【アトリエ(編集画面)】
左下の「+」ボタンは、参照軸を追加できる編集専用の操作。

【ショーケース(閲覧専用画面)】
同じ位置に「+」ボタンがない。土台は同じで、編集操作だけが存在しない。
After: 表示だけを担う部品と、それを内側に包んで編集の状態を持つ部品に分割した。閲覧専用画面は前者だけを、編集画面は後者を呼ぶ。
// 表示専用の部品:渡された値を描画するだけ。編集の状態を一切持たない
export function AxesScale({ axes, selectedAxisId, onAxisTap }: AxesScaleProps) {
return <AxisTicks axes={axes} selectedAxisId={selectedAxisId} onTap={onAxisTap} />;
}
// 編集専用の部品:表示専用の部品を包み、編集の開閉・下書き・検証をここに閉じ込める
export function AxesEditingLayer({ axes }: AxesEditingLayerProps) {
const [dock, setDock] = useState<DockState>({ kind: 'closed' });
return (
<div>
<AddAxisButton onTap={() => setDock({ kind: 'add' })} />
<AxesScale axes={axes} onAxisTap={(id) => setDock({ kind: 'edit', id })} />
{dock.kind !== 'closed' && <AxisEditPanel dock={dock} />}
</div>
);
}同じ考え方を、より一般化した形でも適用した。readOnly のような真偽値ではなく、値を渡すか渡さないかで機能の有無を決める。
// 却下した案:真偽値で内部分岐する
// <Stage readOnly={true} />
// 採用した案:オーバーレイを渡した場合だけ描画される
<Stage overlaySlot={hasCurrentPosition ? <CurrentPositionOverlay /> : undefined} />Stage は編集可能かどうかを一切知らない。渡された overlaySlot があれば描画し、なければ何もしない。
flowchart LR
subgraph 呼び出し側の責務
A[閲覧画面] -->|表示用の部品だけを渡す| C
B[編集画面] -->|表示用の部品と編集層を渡す| C
end
subgraph コンポーネントの責務
C[渡された状態を
そのまま描画するだけ]
end② 選んだ方針と、手放したもの
新しい利用文脈が増えるたびに、既存の部品へ分岐を足す道と、呼び出し元に部品を選ばせる道がある。後者を選んだ。
- 【優先した価値】部品の内側から分岐が消えること。部品は自分がどの文脈で使われているかを知らず、渡された値を描画するだけになる。利用文脈が増えても、部品内部の検証コストは増えない。増えるのは、ユニットテストで安価に確認できる「呼び出し元の選択」だけになる。
- 【犠牲にした価値】初動の速さと、型定義を見ただけで全モードが分かる発見しやすさ。フラグ1行を足すだけでは終わらず、呼び出し元ごとに部品を組み立て直す初期コストを払う。全体像を把握するには、1つの部品の型定義ではなく呼び出し元を横断して読む必要がある。
ある値に応じて見た目の一部を出し分けること自体は問題ではない。問題になるのは、その値によってコンポーネントの振る舞い(内部の処理経路)が枝分かれする場合である。以降のコストは後者にだけ当てはまる。
③ 技術的負債
解消した負債:組み合わせの掛け算
独立した真偽値が1つ増えるたびに、既存の真偽値すべてとの組み合わせが、コード上は到達可能な状態になる。真偽値が2つなら4通り、3つなら8通り、n個なら2ⁿ通りである。実際に意味を持つ組み合わせは一部でも、検証すべき状態空間の大きさは足し算ではなく掛け算で増える。
- 表示の出し分けは配置に波及しやすい。ある要素の表示・非表示が他の要素の配置に影響する実装(フレックスレイアウト等)は珍しくない。「関係ないから検証しなくてよい」と切り捨てる余地があっても、実務では組み合わせがテストケースに含まれてしまう。
- 増えるのは最も高コストな検証層である。部品単体のロジックはユニットテストで検証できても、複数の部品が組み合わさった最終的な表示は、ブラウザ上で確認するのが最も確実で、ケースが増えるほどE2Eのコストが膨らむ。
モードが1つ増えるたびに、実装コストはほぼ一定のまま、検証すべき組み合わせは掛け算で増えていく。今日は誤差でも、この乖離は際限なく開く。
分岐を呼び出し元の選択へ押し出すと、この検証を安価なユニットテストへ倒せる。E2Eは、主要な利用手順の保証だけに専念できる。
新たに生まれた負債:親の配線の複雑化
分岐を子から親へ移しても、複雑さが消えるわけではない。「何をどう組み合わせてよいか」という知識が、呼び出し元に散らばる。子の複雑さを減らした代わりに、親の配線が複雑になる可能性がある。
flowchart TB
subgraph Before["Before: 分岐は子の内側"]
direction TB
P1[呼び出し元] --> C1["子コンポーネント
if mode === A
if mode === B ..."]
end
subgraph After["After: 分岐は親の配線"]
direction TB
P2["呼び出し元
どの部品を渡すか選ぶ"] --> C2["子コンポーネント
渡された値をそのまま描画"]
end放置すれば、複雑さを移動しただけで何も改善していない状態になる。歯止めとして、画面の構成定義を1つのファイルに集約し、1ファイルが一定の行数を超えたらリントで検知する運用を、他の全ファイルと同じ基準で適用している。移動先の複雑さまで制御できて、初めてこの構造は成立する。
この考え方は、UIコンポーネントに限らない。APIの振る舞い、ドメインロジック、状態機械の分岐にも同じ形で当てはまる。適用の基準は「条件分岐をするな」ではなく、「その条件分岐が、コンポーネントの責務そのものを変えるなら、分離を検討する」である。見た目の微調整に留まる差分にまで適用する必要はない。
④ 経営翻訳
これは、1つの窓口に「個人のお客様用」「法人のお客様用」「社内用」といった例外対応を足し続ける運用を、案件ごとに専用の窓口へ振り分ける運用に切り替えたことに近い。
1つの窓口に例外対応を足すたびに、担当者が覚える手順は増え、対応漏れを防ぐための確認作業は、例外の組み合わせの数だけ増えていく。専用窓口に分ければ、各窓口の手順は単純なまま保てる。代わりに、お客様を正しい窓口へ案内する受付の業務が新たに必要になる。受付の案内ルールが際限なく複雑になれば、負担が窓口から受付へ移っただけになるため、案内ルールの量には上限を設けて管理する。