dataviz は何をしますか?
チャートは、1つの質問に対する答えです。質問を一文で言い表せなければ、チャートを選ぶことはできません。何も答えないチャートは、数字が載った飾りにすぎません。
良いチャートの条件
- チャートごとに1つの質問。 タイトルは質問、またはその答えです。「アナリティクス」ではなく「月間実行回数」。
- 種類は質問に従う。 トレンドは折れ線、比較は棒、割合は1本の積み上げ棒、単一の目標はプログレスバー、ランキングは細い棒の付いたリスト。
- 1つのアクセントカラー。 重要なものだけに使います。それ以外は、1つの色相のニュートラルなステップにします。1つの系列内で虹色を使ってはいけません。
- 面積を持つものはゼロベースライン。 棒グラフと積み上げ棒グラフは常にゼロから始めます。折れ線は、切り詰めが視認可能で明示されている場合に限り、別の場所から始めても構いません。
- 控えめな装飾。 グリッド、軸、ラベルは控えめに。データだけが目立ち、その中でも1つの系列だけが目立ちます。
- 読める数字。 ラベルに単位を含め、1つの書式、
tabular-numsを使用し、精度を偽るような末尾の小数点以下の桁を含めない。
実行方法
- 質問を書く。 一文で:このチャートは誰がどのような判断を下すのに役立つか。「データを表示する」だけなら、削除するかテーブルにします。
- 種類を選ぶ references/charts.md から。正しそうに見えて間違っているチャート(通常はドーナツ)も記載されています。
- 行を整形する。 1つのテーブル、カテゴリごとに1行、系列ごとに1列、表示する単位に既に変換された数字。CSVまたはJSON。事前に二重に集計しない。
- 構築する。
- 高速パス:
node <skill folder>/scripts/chart.mjs data.csv --type line --title "月間実行回数" --unit 回 --accent "#e0a458" --out chart.svg - 種類:
line,bar,stacked,sparkline,progress。オプション:--width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max。 - スタンドアロンSVGを出力し、
role="img"、<title>、<desc>、モノタブラーラベル、控えめなグリッドを含みます。そのままページに配置するか、インライン化してページのトークンでスタイルできます。 - チャートをコンポーネント内に配置する必要がある場合は、手作業で構築します。references/charts.md のレシピは、依存関係のないプレーンなSVGとCSSです。
- 高速パス:
- チェックする 実際に表示されるサイズで、以下のチェックリストと照らし合わせて確認します。720ピクセルで読めるチャートが、280ピクセルでは読めないことがあります。
趣味ではなくルール
- 単純なチャートにチャートライブラリは不要。 4本の棒と1本の折れ線はSVGで30行です。ライブラリは40~120KBのコストがかかり、デフォルトのスタイルを元に戻す必要があり、通常はスクリーンリーダーが読めないキャンバスを出力します。
- 1つの系列を多くの色でエンコードしない。 1つのアクセントカラー、1つの主要な系列。1つのチャートに3つ以上の系列がある場合は、2つのチャートにするか、テーブルにします。
- 色は唯一の信号にしてはいけない。 直接ラベル、位置、または形状の違いを使用します。グレースケールで機能しないチャートは、12人に1人の男性にとって機能しません。
- テキストは本当のテキスト。 SVGの
<text>要素を使用し、パスは使いません。これにより、読者の設定に応じて拡大縮小します。画像にラベルを埋め込まない。 - コンテナを尊重する。
viewBoxに加えてwidth:100%、height:auto、max-width、およびラベルが収まらなくなるmin-widthを設定します。375ピクセル幅では、チャートを縮小するのではなく、目盛りと棒の数を減らします。 - 偽のデータは禁止。 数字がプレースホルダーの場合、チャートのタイトルの横にその旨を記載し、レポートにリストアップします。
[必要: 実際の実行回数]は、もっともらしい虚構よりも優れています。 - 単位と比較。 「47回」または「$48,210」。決して「47」だけではありません。変化には常に比較対象を記載します:「前月比+12%」。
- チャートには階層がある。 画面ごとに1つのメインチャートを明確に最大にします。同じサイズの2つ目のチャートがあると、どちらも要点になりません。
チェックリスト
- チャートは1つの名前付き質問に答え、タイトルにそれが記載されている
- 種類が質問に一致している。ドーナツ、6スライスの円グラフ、3D、二重軸は禁止
- 棒グラフと積み上げ棒グラフはゼロから始まっている。切り詰めた折れ線はその旨を記載している
- 重要な系列または点に1つのアクセントカラーが使われ、それ以外はニュートラル
- 3つ以上の系列は2つのチャートまたはテーブルに分割されている
- グリッドと軸は控えめ。チャートの境界線、ドロップシャドウはなし
- ラベルはモノスペース、タブラー数字、1つの数値書式、単位が存在する
- 系列が複数ある場合は凡例があり、1つの系列の場合は凡例は不要
- 変化が示されている場合、すべての数値に比較対象が記載されている
-
role="img"、<title>、<desc>でチャートが何を示しているかが言葉で説明されている - 375ピクセル幅および200%ズームで読める。クリップやラベルの重なりがない
- グレースケールで機能する。色が系列間の唯一の違いではない
- プレースホルダーデータはページ内でマークされ、レポートにリストされている
- 数値は名前を挙げられるソースに遡れる
チャートタイプの表、よくある間違い、そして手作業で構築するSVGおよびCSSのレシピについては、references/charts.md を参照してください。