サイドバーシェルパターンと責務分離
背景
現状 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によるサイドバー: 本文中央固定と両立しない (通常フローに乗るため本文位置がずれる)