サイドバー折りたたみ閾値の SSOT 化と現状追認
背景
--sidebar-collapse-breakpoint(1352px)を変更しても挙動が変わらないという事象を調査した。
調査結果
閾値 1352px は src/styles/global.css の :root に定義されているだけで、実際の判定ロジックからは参照されていなかった。以下 3 箇所に 1351 がハードコードされていた。
src/scripts/sidebar-toggles.client.ts:69src/layouts/HomeLayout.astro(<head>inline script)src/layouts/EntryLayout.astro(<head>inline script)
CSS カスタムプロパティは @media の条件式や window.matchMedia() の引数に直接渡せないため、JS 側では getComputedStyle 経由での参照が必要。
対応
CSS 変数を SSOT として JS 側で読み出す構造に変更した。
sidebar-toggles.client.tsにgetCollapseBreakpoint()を追加し、getComputedStyle(document.documentElement).getPropertyValue('--sidebar-collapse-breakpoint')から値を取得- 各 Layout の inline script(FOUC 回避目的)にも同じロジックを埋め込み
- localStorage 由来の設定固着バグ(
'0'保存で狭い幅でも展開されたまま)を防ぐため、「狭い幅では localStorage を無視して強制 collapse」をcomputeCollapsed()に集約 - collapse 閾値の MediaQueryList に change リスナを登録し、リサイズ追従を追加
追加調査で判明した齟齬
ユーザーの本来の要求は「1352px を境にヘッダー・フッター・ボディを含むレイアウト全体をモバイル/デスクトップで分岐したい」というものだった。
現在の実装は 2 段構えの閾値:
- 768px:モバイル/デスクトップの分岐(
DESKTOP_MQ) - 1352px:デスクトップ内でのサイドバー折りたたみ閾値
要求を満たすには両閾値を 1352px に統一し、SidebarShell / SidebarDrawer / Header / Footer / body padding 等の切り替え条件を全て書き換える必要がある。影響範囲が広く、ハンバーガーの表示条件・サイドバー折りたたみ機能自体の存廃も再設計対象となる。
判断
現状の挙動を許容範囲とし、レイアウト分岐の 1 本化はスコープ外とする。以下を正とする:
--sidebar-collapse-breakpoint: 1352px(CSS 変数として SSOT 化済み、JS からも参照される状態)- モバイル/デスクトップ分岐: 768px(既存のまま)
- 中間幅(768〜1351px): デスクトップレイアウト + サイドバー既定折りたたみ
変更ファイル
src/scripts/sidebar-toggles.client.tssrc/layouts/HomeLayout.astrosrc/layouts/EntryLayout.astro
残課題(着手しない)
- レイアウト分岐閾値の 1352px への統一
- サイドバー折りたたみ機能自体の要否再検討
src/content/ja/decisions/2026-09-22-layout-tokens.md内の古い値(1304px)の更新
教訓
- CSS 変数を定義しても JS 側が参照していなければ SSOT にならない。定義と参照の両輪を確認する
- 「閾値が反映されない」という報告に対し、閾値の値だけを疑って修正すると、そもそも役割の理解がズレていた場合に的外れな修正を重ねる。ユーザーの期待する挙動を先に確認すべきだった