decisiondecided

サイドバーシェルパターンと責務分離

背景

現状 Sidebar.astro (デスクトップ用) と SidebarDrawer.astro (モバイル用) が存在するが、以下の問題を抱えている:

  • デスクトップでもドロワーが開いてしまう不具合: ハンバーガートリガー および SidebarDrawer に md:hidden 相当の排他制御がなく、 デスクトップでもモバイル用ドロワーが動作する
  • サイドバー折りたたみ機能が未実装: 本文と視覚的に衝突する ビューポート幅 (768-1303px) でユーザがサイドバーを退けられない
  • 今後追加予定の TOC サイドバー (詳細ページ用) と、既存フィルタ サイドバー (一覧ページ用) で、配置・折りたたみロジックが重複する懸念
  • サイドバーの外枠 (fixed 配置・アニメーション・トグルボタン) と 中身 (フィルタリスト・TOCリスト) の責務が混在している

これらを一度の設計で整理する。

決定

1. SidebarShell.astro を新設し、外枠責務を集約する

以下の責務を SidebarShell.astro に集約:

  • position: fixed によるビューポート左端への配置
  • 折りたたみ状態管理 (data-collapsed 属性、localStorage 永続化)
  • 折りたたみトグルボタン (Material Symbols: chevron_left / chevron_right)
  • アニメーション (transform: translateX(-100%), 200ms ease-out)
  • レスポンシブ表示制御 (hidden md:block)

中身は <slot /> で受け取る。

2. 中身コンポーネントの責務分離

コンポーネント責務使用場所
Sidebar.astro一覧ページ用: type/tag フィルタリストHomeLayout.astro
TocSidebar.astro (新設)詳細ページ用: 章一覧 (TOC)記事詳細ページ
SidebarShell.astro (新設)上記2つの外枠 (fixed配置・折りたたみ)両方
SidebarDrawer.astroモバイル専用フルスクリーンドロワー、中身は <slot />全ページ (モバイルのみ)

3. レスポンシブ表示マトリクス

ビューポート幅デスクトップサイドバーモバイルドロワーハンバーガーボタン折りたたみトグル
≥1304px表示 (トグルで折りたたみ可)非表示非表示表示
768-1303pxデフォルト折りたたみ (トグルで表示)非表示非表示表示
<768px非表示ハンバーガーで開く表示非表示

//2026-09-25:
有名サイトを見ると、サイドバーは280pxか320px、ビュー全体は1280px幅が分かりやすかった。モバイルは768px基準でいい。

4. 排他表示の実装

  • Header.astro のハンバーガートリガーに md:hidden を付与
  • SidebarDrawer.astro の <aside> に md:hidden を付与
  • SidebarShell.astro に hidden md:block を付与
  • ドロワーとデスクトップサイドバーが同時に描画・表示されないことを保証

5. 折りたたみ状態の永続化

  • キー: parlourite:sidebar-collapsed
  • 値: 'true' | 'false'
  • SSR 時の FOUC 回避のため、<html> 開始直後に <script is:inline> を配置し、 <html> に data-sidebar-collapsed 属性を早期付与する
  • CSS はこの属性を参照して初期状態を決定

6. モバイルドロワーの内容切替

ドロワー内のコンテンツはページ種別で切替:

  • 一覧ページ: フィルタ (type/tag)
  • 詳細ページ: TOC (章一覧)

実装は SidebarDrawer.astro に <slot /> を配置し、各ページから 適切な中身を渡す方式とする。

理由

  • シェルパターン: 配置・アニメーション・折りたたみロジックは 中身に依存しない汎用機能。中身と分離することで再利用性と保守性が向上
  • slot による中身注入: 継承や条件分岐ではなく Astro 標準の slot を 使うことで、Astro のコンポーネントモデルに整合
  • 1304px 切替点: ADR 2026-09-22-layout-tokens の衝突判定式に準拠。 独自の数値は持たない
  • localStorage prefix: プロジェクト固有の名前空間 (parlourite:) を 付けることで、将来他アプリと同一オリジンで動作する場合の衝突を回避
  • FOUC 回避 script: hydration 後にクラス付与すると、初期描画で サイドバーが一瞬展開して閉じる挙動になるため、<html> 属性を 早期付与する方式を採用

影響

  • Sidebar.astro を、外枠を持たない中身のみのコンポーネントにリファクタ
  • SidebarShell.astro および TocSidebar.astro を新規作成
  • HomeLayout.astro および記事詳細ページのレイアウトを、 SidebarShell でラップする形に変更
  • Header.astro のハンバーガーボタンに md:hidden を追加
  • SidebarDrawer.astro の中身を <slot /> 化し、各ページから フィルタ or TOC を渡す

代替案(却下)

  • 既存 Sidebar.astro を拡張して折りたたみ対応: 外枠と中身の責務が さらに混在し、TOC サイドバー追加時に重複が発生
  • CSS-only 折りたたみ (:checked トリック): 状態の永続化ができない
  • ドロワーとデスクトップサイドバーを同一コンポーネントで扱う: 表示 ロジックが複雑化し、レスポンシブ挙動のテストが困難
  • position: sticky によるサイドバー: 本文中央固定と両立しない (通常フローに乗るため本文位置がずれる)