アイコン統一ポリシー
背景
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 に使用可能アイコン一覧を維持する。新規アイコン追加時は:
docs/ICONS.mdにアイコン名と用途を追記- 追記の PR/コミットで既存アイコンで代替可能かをレビュー
- 承認後にコードで使用
初期ホワイトリスト (現時点で必要と判明しているもの):
| アイコン名 | 用途 |
|---|---|
arrow_back | 前記事ページャ |
arrow_forward | 次記事ページャ |
chevron_left | サイドバー折りたたみ (開閉トグル) |
chevron_right | サイドバー展開 (開閉トグル) |
menu | モバイルハンバーガー |
close | ドロワー閉じる |
search | 検索アイコン (将来の Pagefind 統合用) |
arrow_upward | back-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 で十分カバー可能
- ホワイトリストなし・自由運用: 短期的には楽だが、長期的に アイコン数が発散し視覚的統一性が崩れる