レイアウト共通トークンとブレークポイントの確定
背景
これまで一覧ページ (HomeLayout.astro) と記事詳細ページ ([id].astro) で
本文カラムの max-width やパディング、サイドバー幅が個別に定義されており、
以下の問題が発生していた:
- 一覧と詳細で本文の横幅・左右余白が微妙に異なり、遷移時に違和感
- ブレークポイントが複数箇所でハードコードされ、変更コストが高い
- サイドバーの折りたたみを実装する際に、レイアウトシフトの計算基準が存在しない
- モバイル対応で本文がはみ出す不具合の根本原因調査が困難
UI整備を進める前に、レイアウトに関する数値定数を一元管理し、 以降のUI関連ADRから参照される SSOT を確立する必要がある。
決定
1. レイアウト方針: 本文中央固定 + サイドバー左端固定
- 本文カラムは
margin-inline: autoによりビューポート中央に配置 - サイドバーは
position: fixedで左端に貼り付け、本文レイアウトに影響しない - サイドバー折りたたみ時も本文位置は不変(レイアウトシフトゼロ)
2. CSS 変数による共通トークン
src/styles/parlourite.css の :root に以下を定義:
--content-max: 720px — 本文カラムの最大幅--sidebar-width: 260px — サイドバー幅--sidebar-gap: 32px — 本文とサイドバーの視覚的最小余白--layout-gutter: 24px — 本文の左右パディング--header-height: 56px — ヘッダー高さ--content-padding-block: 48px — 本文の上下余白--sidebar-collapse-breakpoint: 1304px — サイドバー常時表示切替点
モバイル (max-width: 767.98px) では以下を上書き:
--layout-gutter: 16px--content-padding-block: 32px
3. ブレークポイント
単一の主境界 768px と、副境界 1304px の2点のみを採用する。
| 境界 | 用途 |
|---|---|
| 768px | モバイル / デスクトップの主境界(ドロワーとサイドバーの排他) |
| 1304px | サイドバー常時表示 / デフォルト折りたたみの切替 |
4. 常時表示切替点の計算式
本文中央固定とサイドバー左端固定が視覚的に衝突しない条件:
現行値を代入:
したがって切替点は 1304px。トークン値を変更する場合、この式で再計算する。
理由
- 本文中央固定: 高級ホテル風テーマの視覚重心を安定させる。サイドバー 折りたたみ操作で本文が左右に動くのは Apple/Stripe/Linear 等の 高級UIでは避けられており、Parlourite の方針と一致する
- CSS 変数: 変更時に一箇所を触るだけで済み、ADR で数値を管理しやすい
- ブレークポイント2点のみ: Tailwind の 5段階等は運用複雑度を上げる。 「シンプルで手堅い」原則に従い、必要最小限に絞る
- 本文幅 720px: 65-75文字/行の可読性基準に合致。コードブロックは 横スクロールで対応するため、これ以上広げる必要がない
- サイドバー幅 260px: VitePress 272px, Stripe 240px の中間。 type/tagフィルタの日本語ラベルと Material Symbols アイコンを 無理なく収容できる幅
影響
HomeLayout.astroおよび記事詳細ページで、レイアウト定義を 本ADR定義のトークンに置き換える- ハードコードされたブレークポイント値 (
768px等) を、@mediaの 条件式または--sidebar-collapse-breakpoint参照に置換 - 以降の UI 関連 ADR (
sidebar-shell-pattern,toc-sidebar-adoption等) は本ADRのトークンを参照し、独自の数値を持たない
代替案(却下)
- 本文左寄せ + サイドバー通常フロー配置: 一般的なブログレイアウトだが、 サイドバー折りたたみ時に本文が左に大きく寄り、大画面で違和感が出る
- 3カラムレイアウト(左サイドバー / 本文 / ダミー右余白): 本文中央 配置は達成できるが、サイドバー折りたたみ時に本文位置がズレる
- Tailwind 標準の 5段階ブレークポイント (sm/md/lg/xl/2xl): 運用複雑度 が Parlourite の規模に見合わない
- 本文幅 800px 以上: 日本語本文の可読性が低下する(1行あたり文字数過多)