Checkbox Hackは何を優先したのか:制御の所有者をブラウザへ返すという価値選択、そして採用しない判断
Checkbox Hackは、ナビゲーションの開閉制御をReactの状態管理からブラウザネイティブのフォーム要素へ返すことを優先している。
① Checkbox Hackは何を優先したか
一般的なナビゲーションドロワーの実装は、useState で開閉状態を持ち、useEffect でEscキーとスクロールを検知して閉じる。この構造は、Reactのハイドレーション完了を前提にしている。Cloudflare Workersのコールドスタートが重なると、ユーザーが最初にハンバーガーボタンを押した瞬間が「反応しない」時間帯に当たることがある。
Checkbox Hackは input[type="checkbox"] と label、CSSの :has() 擬似クラスを組み合わせ、状態変化をブラウザネイティブのフォーム要素に委ねる。チェックボックスの状態変化はHTMLが届いた瞬間から機能し、Reactのハイドレーションを待たない。
- 【優先した価値】: Hydrationギャップの構造的排除。HTMLが届いた瞬間からボタンが反応する
- 【犠牲にした価値】: インタラクション機能の完全性。Escキーで閉じる、スクロールで閉じるといった挙動は、キーボードイベントもスクロールイベントもCSSに公開されていないため再現できない
② ClaudeMixでやったこと
Before(現状): ナビゲーションドロワーは useDrawer.ts が useState と useEffect で開閉を管理している。Escキー・スクロールクローズを含めて実装済みで、動作している。
// app/components/blog/common/useDrawer.ts(現状)
export const useDrawer = () => {
const [isOpen, setIsOpen] = useState(false);
useEffect(() => {
if (!isOpen) return;
const handleKeyDown = (event: KeyboardEvent) => {
if (event.key === 'Escape') setIsOpen(false);
};
const handleScroll = () => setIsOpen(false);
window.addEventListener('keydown', handleKeyDown);
window.addEventListener('scroll', handleScroll, { passive: true });
return () => {
window.removeEventListener('keydown', handleKeyDown);
window.removeEventListener('scroll', handleScroll);
};
}, [isOpen]);
return { isOpen, setIsOpen };
};After(評価結果): Checkbox Hackへの全面移行を検討し、採用しないと判断した。Escキー・スクロールクローズだけをJSで補うPartial-JS構成を仮に組んだ場合の構造も検証した。
// 検証した仮の構成(採用しない)
const getCheckbox = () =>
document.getElementById('nav-drawer-toggle') as HTMLInputElement | null;
useEffect(() => {
const handleKeyDown = (event: KeyboardEvent) => {
if (event.key === 'Escape') {
const checkbox = getCheckbox();
if (checkbox?.checked) checkbox.checked = false; // DOMを直接操作
}
};
window.addEventListener('keydown', handleKeyDown);
return () => window.removeEventListener('keydown', handleKeyDown);
}, []);この構成では「ドロワーが開いているか」の正解がCSSが読むチェックボックスのDOM状態にしか存在せず、isOpen という変数がコンポーネントツリーから消える。useDrawer.ts を現状維持することにした。
③ 技術的負債
- 【解消した負債】: なし(採用しなかったため、Hydrationギャップは構造として残っている)
- 【新たに生まれた負債(あれば)】: なし。現状の
useDrawer.tsはEscキー・スクロールクローズを含めて完成しており、追加の負債は発生していない
Checkbox Hackを部分適用した場合に生じるPartial-JSの複雑さ(状態の管理者がCSSとJSの2つになる)は、本文で構造として記述できるが、デバッグ時間の増加量として数え直せる定量値は存在しない。そのため実測値による比較は行わない。
④ 経営翻訳
受付の開閉操作を、備え付けの物理スイッチ1つに任せる案と、係員が状況を見て開閉を判断する案を比較検討した。物理スイッチは反応が速い一方、「非常時は自動で閉める」「一定時間操作がなければ自動で閉める」といった判断はスイッチ単体では表現できない。それを別の係員が補う体制にすると、開閉の管理者が2人になり、どちらが今の状態の正解かを都度確認する必要が生まれる。
今回は、既に非常時対応まで含めて機能している係員配置を維持し、物理スイッチへの切り替えは見送った。受付の混雑がさらに増し、反応速度が業務上の問題になった時点で、この判断を再評価する。