この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。架空のデータとブラウザの操作を使って、D3.jsの用途、仕組み、失敗時の観察ポイントを学びます。実在のサービスや個人情報へのアクセスは行いません。
検証ステータス： 2026-10-30に公式資料とGitHub固定コミットのHTML/JavaScriptを照合しました。実ブラウザ操作・CDN取得・描画/音声出力は未実行で、本文の結果はコードからの期待値です。
| 項目 | 内容 |
|---|---|
| 対象 | Chrome/Edge/Firefox等の現代的なブラウザ（実機互換性は未確認） |
| 使用ライブラリ | D3.js（教材内バージョン: 7.9.0） |
| 費用 | デモのソース自体に有料APIは不要。通信料金や利用条件は環境に依存 |
| データ | ページ内の架空データ。認証情報・位置情報・企業データ不要 |
| 学習操作 | 動物へ投票するたびに円の大きさと票数を変更する |
なぜこの技術を試すのか
グラフを描くライブラリはいくつもありますが、D3.jsは細かな表現を自分で組み立てる自由度が高いのが特徴です。今回のテーマは架空の動物人気投票で、パンダ・ネコ・フクロウの票数を円として表示します。投票ボタンを押すと円が大きくなり、票数のテキストも更新されます。単なる丸のサイズ変更ではなく、値の変化と画面要素がどう結び付くかを観察する教材です。Graphライブラリを選ぶ前に、既成の棒グラフで十分なのか、独自の視覚表現が必要なのかを考えます。
動くサンプルを作るときは、見た目が動いたという事実だけで終わらず、「どの入力がどの変数を変え、どの処理が描画を更新したか」を区別する必要があります。今回の教材では、その変化を画面に明示します。実際のサービスへ取り込むときには、認証や保存の処理を別途設計してください。
まず試す：ライブデモと期待する結果
最初はパンダ3票、ネコ2票、フクロウ1票という架空の数値です。ネコへ一票入れ、パンダと同数になったときに円の半径が等しくなるか観察します。次にリセットして全動物を0票にし、円が見えなくなっても各動物の名前と0票は残ることを確認します。画面下には合計票数を文章で示します。円だけの画像では何票なのか正確に読みにくいため、数値のテキストを必ず併記するのがポイントです。
操作の前に確認すること
自分のPCがJavaScriptを実行できることを確認します。管理者権限は必要ありません。
ブラウザの開発者ツールを開き、Consoleでエラー、NetworkでCDN取得失敗がないか見る準備をします。
デモが実際に公開されていない場合は、Daily Code側の
index.htmlとapp.jsを同じフォルダに保存して、ローカルHTTPサーバーで開きます。moduleを使う場合、file://での直接実行は動作保証されません。結果を操作前後で比べます。期待値と異なる場合は「何が表示されなかったか」を先に記録します。
仕組みの全体図
flowchart LR
A["入力やクリック"] --> B["イベントを受ける"]
B --> C["D3.js のAPI"]
C --> D["状態と描画を更新"]
D --> E["見た目と文字で確認"]
この図は学習用の概念図で、ブラウザ内部の実装やネットワーク通信の詳細を表したものではありません。ライブラリが何でも「操作がどの変数へ届くか」を追いかけることは共通です。
公開デモが使えない場合のローカル確認
固定コミットのHTML本体とJavaScript本体をGitHubのRaw表示から、それぞれindex.htmlとapp.jsとして同じ新規フォルダに保存します。READMEだけでは動作しません。WindowsではそのフォルダでPowerShellを開きpy -3 -m http.server 8000 --bind 127.0.0.1、Linux/macOSではpython3 -m http.server 8000 --bind 127.0.0.1を実行し、同じPCのhttp://127.0.0.1:8000/を開きます。終了はターミナルでCtrl+Cです。ブラウザがライブラリ本体を外部CDNから取得するため、接続できない場合はConsoleとNetworkのエラーを確認します。この手順は再現案内であり、本記事のブラウザ実測報告ではありません。
どう動いているのか：APIを読み解く
D3のselectはDOM要素を対象にし、dataは各要素とデータを結び付けます。joinは表示対象の数が変わったときに、要素を新規作成・更新・削除する方法をまとめて扱えます。SVGはHTMLに埋め込めるベクター形式なので、円とテキストをそれぞれ要素として持てます。今回の円の半径は投票数をそのまま掛け算するのではなく、scaleSqrtで平方根スケールへ変換します。円の面積は半径の二乗に比例するため、半径を数値へ比例させると量の差を過大に見せるからです。
最小コードの読み方
const scale = d3.scaleSqrt().domain([0, 30]).range([0, 75]);
svg.selectAll("circle").data(votes, d => d.name).join("circle")
.attr("r", d => scale(d.count));
上記はAPIの要点を取り出した抜粋です。コピーして単独実行する完成ファイルではありません。動かすためのHTMLと実装一式はDaily Code側のREADME／デモファイルで確認してください。どの関数がHTML要素を選び、どの行が数値を更新するかを追い、既知の架空値で試します。
一条件だけ変更して比較する
色を動物ごとに変えた場合でも、色だけで判断させず名前を表示します。SVGへ棒グラフを追加するなら、同じdata配列を使って複数の表示形式を作れます。transitionの長さを0にすると瞬時に更新されますが、値の大小そのものは変わりません。見せ方を変えるときにデータ処理まで変えてしまわないよう、値の更新関数と描画関数を分離します。
比較の手順は、最初の値を記録し、一か所だけ変更して、結果が想定の部分に現れたかを確認することです。入力を一度にいくつも変更すると、何が影響したか分からなくなります。変更前へ戻す操作まで含めて検証してください。
失敗したときにどこを見るか
円の数が多すぎる場合、ラベル同士が重なって読めなくなります。また、円の面積を適切に調整しても、散らばった円だけでは正確な順位が比較しにくいことがあります。順序が重要なら棒グラフの方が向く場合もあります。さらに、transitionの途中で何度も更新が起きることを前提にして、描画の整合性を確認する必要があります。今回のデモは投票を保存しないため、再読み込みで初期値に戻ります。
| 観察した状態 | 切り分ける点 | 対応の例 |
|---|---|---|
| 画面が初期状態から変わらない | スクリプト取得・初期化・イベント登録 | Console / Network / scriptタグを確認 |
| 表示が変わるが意味が合わない | 入力値・配列・単位・更新対象 | 値を固定して一条件ずつ確認 |
| ボタンを押せない | セレクターとDOM生成順序 | idが一致するかHTMLを確認 |
| 一部の端末だけ動かない | ブラウザ機能、権限、CDN、性能 | 端末とバージョン、再現操作を記録 |
ブラウザ内でのエラーと公開Webサーバーの障害は別です。前者は開発者ツールのエラー内容、後者はHTTPレスポンスやアセットの配信条件から調べます。未知の失敗を成功と表現しないことが、技術メモの信頼性を高めます。
業務・学習への応用
アンケート結果、カテゴリの構成、教育教材、展示物などに使えます。実際の選挙や公式集計のような用途では、表示前の票数集計・監査・署名・改ざん防止を別に実装しなければなりません。D3は見せ方のライブラリであり、投票の公正性を保証するものではありません。
導入前に決めること
読者へ公開するとき、表示したデータがどこから来るか、誰が変更できるか、画面へ残る情報の種類、ライブラリ更新時の確認項目を決めます。今回のデモにはログインもサーバー保存もありません。そこで運用機能を追加する前に、まず「想定どおり表示される最小部分」と「実務上の信頼性・権限・バックアップが必要な部分」を区別することを勧めます。第三者CDNは外部通信のため、企業ネットワークで許されるか事前確認が必要です。
別方式と比較する
| 方式 | 向く場面 | 注意点 |
|---|---|---|
| D3.js | 動物へ投票するたびに円の大きさと票数を変更するなど目的に合う場面 | 依存ライブラリの更新・利用条件の管理が必要 |
| ブラウザ標準API | 小さな機能を自前で作る | 仕様や互換性を自分で確認する |
| 静的画像・表 | 操作を必要としない説明 | 状態の変化をその場で体験できない |
ライブラリは必要なときに選ぶ道具です。何を達成したいかと学習コストを合わせて比較します。「ライブラリを入れること」を目的にしない方が、小規模なページでは保守しやすくなります。
GitHubサンプル
ブログ本文は背景や考え方、Daily Codeは実行・改造するためのコード、という役割を分けています。外部サービスへ投稿・保存するAPIは含めません。
公式情報・一次情報
資料確認範囲： 2026-10-27の編集時点で公式ドキュメントを参照。リンク先の将来の変更やすべてのCDNアセット応答まで保証するものではありません。
検証範囲の補足
GitHubに保存された固定ソースと公式API説明を照合しました。ブラウザ操作、CDNロード、各OS上での結果は未検証です。実際の動作確認時にはConsoleとNetworkを確認し、画面のSUCCESS表示だけで全条件の成功を断定しないでください。
