Component Library ── Visual Explainer

Visual Explainer Components ── 図解解説HTMLのデザイントークン・UI部品・ダイアグラム実例集

図解付き解説ページを同じ品質で量産するためのコンポーネントギャラリーです。Claude Code では visual-explainer スキルが本デザインシステムを自動適用します。人間はこのページをブラウザで開いて部品を確認し、ソース表示でコードをコピーできます。

Usage / 使い方
Claudeへの依頼例:「この記事を図解で解説して」「あのデザインで解説ページを作って」→ visual-explainer スキルが発動。デプロイは html-theme-deploy スキルが担当(Cloudflare Pages)。スキル本体:~/.claude/skills/visual-explainer/(SKILL.md・theme.css・skeleton.html・diagrams.md)。初出の実績ページ:designing-loops-fable5.pages.dev
01

デザイントークン

カラーパレット

--ivory #FAF9F5
背景
--paper #FFFFFF
カード面
--slate #141413
本文・終端ノード
--clay #D97757
主役アクセント
--clay-d #B85C3E
アクセント濃
--olive #788C5D
第2アクセント
#FBEFE7
clay系ノード面
#EEF1E7
olive系ノード面
--g100 #F0EEE6
--g200 #E6E3DA
--g300 #D1CFC5
枠線
--g500 #87867F
補助文字

タイポグラフィ・原則

項目規定
書体sans-serif統一(游ゴシック→Hiragino Sans→Meiryo→system-ui)。serif・斜体は全面禁止
本文18px / line-height 1.75(一般的な16pxより大きめ)
h1 / h2clamp(38px, 5.4vw, 62px) / clamp(25px, 2.8vw, 32px)・weight 600
セクション番号mono・clay色・clamp(36px, 4vw, 46px)=見出しの約1.4倍
monoラベル11〜14px / UPPERCASE / letter-spacing 0.08〜0.12em(eyebrow・図キャプション・軸ラベル)
カードborder 1.5px var(--g300)・radius 14px・ホバーで border-color: slate+浮き上がり
強調見出し中の <em> は色のみ(clay)。太字は weight 600
02

UI部品

ヘッダー系 ── .eyebrow / .src-card / .toc

UI-01 ── eyebrow(見出し上のキッカー)
Article Explainer ── Sample Kicker
UI-02 ── src-card(出典カード・全ページ必須)
Source / 出典
著者名「記事タイトル」媒体名、閲覧日。本文・図表の著作権は原著者に帰属。本ページは非公式の日本語要約・図解であり、掲載図は独自再構成の概念図。
UI-03 ── toc(目次ピル)

本文系 ── .stats / .quote / .takeaway / .gloss

UI-04 ── stats(定量ハイライト3列)
約 6 倍
主要な定量結果のハイライトをここに
9 基準 × 8 時間
組み合わせ数値もmonoで映える
最高スコア
短い結論ワードでも可
UI-05 ── quote(引用ボックス)+ UI-06 ── takeaway(結論ボックス)

「引用文はカギ括弧で明示する。意訳には(大意)を添える」(大意)

── 発言者名(出所の説明)
Takeaway ── 実務への示唆

セクションや記事全体の結論・実務への示唆をここにまとめる。左の縦線がclay、ラベルはmono大文字。

UI-07 ── gloss(用語ミニ解説・4語まで)
用語A
13px程度の短い説明文をここに置く
用語B
1〜2行で収まる分量が目安
用語C
monoの用語名+ゴシックの説明
用語D
5語以上になるなら表を使う

比較系 ── table / .cmp-grid / .steps

UI-08 ── table(仕様・事実の比較表)
観点選択肢 A選択肢 B
形式行見出しはmono小文字セルは15.5pxの本文
用途列挙可能な事実の対比性格の対比なら .cmp-grid を使う
UI-09 ── cmp-grid(性格対比カード:主役 .clay vs 比較対象 .gray)

主役 A大胆な戦略

  • 強調したい側を clay 背景に
  • 箇条書きは currentColor のダッシュ

比較 B堅実な戦略

  • 比較対象側はグレー背景
  • 3項目程度までが読みやすい
UI-10 ── steps(段階的プロセス・矢印つき)
01 ── PHASE
第1段階

各ステップの説明を13.5pxで

02 ── PHASE
第2段階

モバイルでは縦並びに自動切替

未確定の段階

破線 .ghost で「続き」を表現

図版・出典 ── .fig / .srcs

UI-11 ── fig(図版コンテナ:cap+diagram+note。この枠自体が実例)

※ fig-note には概念図の再構成注記を必ず書く。SVGは .diagram(min-width:600px・スマホ横スクロール)、小さい図は .diagram.narrow+.grid2 で2枚並べる。

UI-12 ── srcs(出典リスト)
  • 一次出典:著者「タイトル」媒体・公開日・閲覧日
  • 言及資料:記事内で参照されている資料を列挙する
03

SVGダイアグラム 8種

座標・クラスはすべて動作検証済み。references/diagrams.md のレシピ番号(§1〜§8)と対応しています。ラベルを差し替えてそのまま使えます。

D-01 ── フローチャート(§1:手順・分岐・修正ループ)
基準(ゴール)を定義 処理を実行 第三者が結果を評価 基準を満たした? はい 完了(基準達成) いいえ 指摘を基に 修正して再実行 評価者の例 独立したモデル 採点用サブエージェント 上限(バウンド)の例 回数・時間の上限 到達したら強制停止
D-02 ── シーケンス図(§2:役割間のやり取り・ループ枠つき)
依頼者 実行役 検証役(独立した文脈) 基準(ルーブリック)を渡す 作業ループ(試行 → 計測) LOOP ── 合格まで 評価を依頼 基準で採点 不合格 + フィードバック 修正・再試行 合格 完了を報告
D-03 ── ループ型アローダイアグラム(§3:サイクル)
計画する 仮説を立てる 実行する 処理を起動 観察する ログを監視 計測する スコアを読む 次を決める 仮説を更新 条件を満たすまで自律的に繰り返す
D-04 ── 関係図・相関図(§4:2パターン対比・自己ループ・境界)
A ── 自己完結パターン 同一の文脈・境界 役割A(作業+確認) 自分の成果物を自分で確認 確認が甘くなりやすい構図 B ── 分離パターン 役割A(作業) 独立した文脈 役割B (確認) 成果物 フィードバック 独立した視点で確認する構図
D-05 ── ベン図(§5:3要素の重なり・成立条件)
条件A (測れる基準) 条件B (独立した視点) 条件C(上限と終了) A∩B の補足 A∩C の補足 B∩C の補足 3条件で 成立する結論

※ 解釈を含む整理には「原典を基に作成者が整理」の注記を付けること。

D-06 ── 折れ線グラフ(§6:推移・2系列比較・注釈・差分ブラケット)
指標(低いほど良い) 0 5 10 15 20 試行回数(0 = 基準値) ベースライン 系列A(主役) 系列B(比較) 一時的な悪化 大きな改善 差分の注釈

※ 実データを再現できない場合は「傾向の概念的な再構成」と必ず明記する。

D-07a ── 棒グラフ(§7:相対比較)
結果の比較(相対イメージ) 正確な値が不明なら数値軸を書かない SCORE 案A 案B 案C 最高
D-07b ── 推移曲線(§7:grid2で並べる)
スコアの推移(概念) 時間・回数とともに改善する様子 進行 → 系列A 系列B 系列C
D-08 ── 入れ子ループ図(§8:二重構造・包含・ストレージ円筒)
外側ループ ── 蓄積と再利用(横断) 1つの処理単位(セッション) 内側ループ ── 自己修正 実行 評価・フィードバック 自己修正 ストア 永続化レイヤー(処理単位をまたいで共有) 書き込み 次回の処理で読み出し