decisiondecided

アイコン統一ポリシー

背景

Parlourite Notes は高級ホテル風のトーンとノイズの少ない UX を採用して おり、絵文字の使用は視覚的な調和を乱す。プロジェクトには既に src/assets/fonts/material-symbols-outlined.woff2 が配置され、 Material Symbols を用いる方針が定められているが、以下の違反が確認された:

  • 記事詳細ページ下部の「新しい/古い記事へ」のページャに矢印絵文字が 使用されている
  • 他にも絵文字が混在している可能性があり、体系的な洗い出しと 再発防止のポリシー整備が必要

また、アイコン使用を各実装者の裁量に任せると、都度新しいアイコンが 追加され、視覚的一貫性が損なわれるリスクがある。

決定

1. 使用可能なアイコンは Material Symbols Outlined のみ

  • フォントファイル: src/assets/fonts/material-symbols-outlined.woff2
  • 参照方法: CSS font-family: 'Material Symbols Outlined' + ligature (<span class="icon">arrow_back</span>)
  • SVG インラインアイコン、他アイコンフォント、絵文字は全て禁止

2. フォントロード設定

  • font-display: block (FOUT による絵文字→アイコン切替のちらつき回避)
  • unicode-range は指定せず全範囲ロード (アイコン数が多く、範囲指定は 保守コストに見合わない)

3. 既定スタイル

  • サイズ: 20px (本文行内)、24px (ボタン内)、16px (小型 UI)
  • weight: 400
  • fill: 0 (アウトライン)
  • grade: 0
  • optical size: 20

CSS 変数として src/styles/parlourite.css に定義:

  • --icon-size-sm: 16px
  • --icon-size-md: 20px
  • --icon-size-lg: 24px

4. 使用アイコンホワイトリスト

docs/ICONS.md に使用可能アイコン一覧を維持する。新規アイコン追加時は:

  1. docs/ICONS.md にアイコン名と用途を追記
  2. 追記の PR/コミットで既存アイコンで代替可能かをレビュー
  3. 承認後にコードで使用

初期ホワイトリスト (現時点で必要と判明しているもの):

アイコン名用途
arrow_back前記事ページャ
arrow_forward次記事ページャ
chevron_leftサイドバー折りたたみ (開閉トグル)
chevron_rightサイドバー展開 (開閉トグル)
menuモバイルハンバーガー
closeドロワー閉じる
search検索アイコン (将来の Pagefind 統合用)
arrow_upwardback-to-top

以降の機能追加で必要になったアイコンは、上記手順で追加する。

5. 絵文字の全面禁止

  • 記事本文、UI コンポーネント、ADR、コミットメッセージ、ドキュメント 全てで絵文字を使用しない
  • 唯一の例外: 外部から引用したテキスト内の絵文字 (改変せずそのまま 表記する場合)

6. アイコンのアクセシビリティ

  • 装飾目的のアイコンは aria-hidden="true" を付与
  • 機能を持つアイコン (ボタン内単独等) は aria-label で意味を明示
  • Material Symbols の ligature テキスト (arrow_back 等) は スクリーンリーダで読み上げられるため、aria-hidden の付与を徹底

理由

  • 視覚的一貫性: 高級ホテル風テーマにおいて、絵文字のカラフルさや プラットフォーム依存の描画差は世界観を損なう
  • Material Symbols 選択: Google 提供、Apache 2.0 ライセンス、 可変フォントで柔軟、既にプロジェクトに導入済み
  • ホワイトリスト運用: 「都度追加」を避け、意図しないアイコン増殖を 抑制。visual audit のコストを下げる
  • font-display: block: 絵文字が瞬間的に見えてから Material Symbols に 切り替わる挙動は、本ポリシーの意図 (絵文字排除) と矛盾するため ブロッキングを許容

影響

  • 記事詳細ページ下部のページャ矢印を絵文字から arrow_back / arrow_forward に置換
  • 全コード・全記事から絵文字使用箇所を grep で洗い出し、置換または削除
  • docs/ICONS.md を新規作成し、ホワイトリストを記載
  • src/styles/parlourite.css にアイコンサイズ変数を追加
  • Material Symbols フォントロードの font-display 設定を確認・調整
  • 今後の PR レビューで絵文字使用を検出する運用ルール化

代替案(却下)

  • 絵文字を許容し、統一絵文字セット (Twemoji 等) を採用: プラットフォーム 依存は解消されるが、高級感の要件を満たさない
  • SVG インラインアイコン (Heroicons 等): 個別 import が必要、 ビルド設定が複雑化。Material Symbols フォント一発ロードの方が単純
  • Font Awesome: 商用ライセンス懸念、フォントサイズが大きい、 Material Symbols で十分カバー可能
  • ホワイトリストなし・自由運用: 短期的には楽だが、長期的に アイコン数が発散し視覚的統一性が崩れる