decisiondecided

レイアウト共通トークンとブレークポイントの確定

背景

これまで一覧ページ (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. 常時表示切替点の計算式

本文中央固定とサイドバー左端固定が視覚的に衝突しない条件:

sidebar_width+sidebar_gap≤viewport−content_max2\text{sidebar\_width} + \text{sidebar\_gap} \leq \frac{\text{viewport} - \text{content\_max}}{2}

現行値を代入:

viewport≥content_max+2×(sidebar_width+sidebar_gap)=720+2×(260+32)=1304 px\text{viewport} \geq \text{content\_max} + 2 \times (\text{sidebar\_width} + \text{sidebar\_gap}) = 720 + 2 \times (260 + 32) = 1304 \text{ px}

したがって切替点は 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行あたり文字数過多)