log

サイドバー折りたたみ閾値の SSOT 化と現状追認

背景

--sidebar-collapse-breakpoint(1352px)を変更しても挙動が変わらないという事象を調査した。

調査結果

閾値 1352px は src/styles/global.css の :root に定義されているだけで、実際の判定ロジックからは参照されていなかった。以下 3 箇所に 1351 がハードコードされていた。

  • src/scripts/sidebar-toggles.client.ts:69
  • src/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.ts
  • src/layouts/HomeLayout.astro
  • src/layouts/EntryLayout.astro

残課題(着手しない)

  • レイアウト分岐閾値の 1352px への統一
  • サイドバー折りたたみ機能自体の要否再検討
  • src/content/ja/decisions/2026-09-22-layout-tokens.md 内の古い値(1304px)の更新

教訓

  • CSS 変数を定義しても JS 側が参照していなければ SSOT にならない。定義と参照の両輪を確認する
  • 「閾値が反映されない」という報告に対し、閾値の値だけを疑って修正すると、そもそも役割の理解がズレていた場合に的外れな修正を重ねる。ユーザーの期待する挙動を先に確認すべきだった