dataviz 是做什麼的?
一張圖表就是一個問題的答案。如果你無法用一句話說出那個問題,你就無法選對圖表,而一張不回答任何問題的圖表,只是上面寫著數字的裝飾品。
好的圖表長怎樣
- 一張圖表只回答一個問題。 標題就是那個問題,或是它的答案。「每月跑步次數」,而不是「分析總覽」。
- 圖表類型跟隨問題。 趨勢用折線圖,比較用長條圖,佔比用一個堆疊長條圖,單一目標用進度條,排名用帶有細長條的清單。
- 一個強調色。 只有重要的東西使用強調色。其他所有東西都是同一色階的中性色調。絕不在一個數列中使用彩虹色盤。
- 任何帶面積的圖表都從零開始。 長條圖和堆疊長條圖一律從零開始。如果折線圖的起點非零,則必須讓截斷處可見並標明。
- 柔和的裝飾。 網格、座標軸和標籤都是低調的。資料是唯一醒目的東西,而且其中只有一個數列是醒目的。
- 可讀的數字。 標籤中帶單位、使用統一格式、
tabular-nums(等寬數字)、沒有誇大精度的尾隨小數。
執行程式
- 寫下問題。 一句話:這張圖表能幫助某人做出什麼決定。如果是「顯示資料」,那就砍掉它,或改成一個表格。
- 選擇圖表類型:參考 references/charts.md。該文件也會指出那些看起來對但其實是錯的圖表,通常是指甜甜圈圖。
- 整理資料列。 一個表格,每種類別一行,每個數列一列,數字已經是你想顯示的單位。CSV 或 JSON 格式,不要做兩次預彙總。
- 建構圖表。
- 快速路徑:
node <skill folder>/scripts/chart.mjs data.csv --type line --title "Runs per month" --unit runs --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>、等寬表格數字和柔和的網格。可以直接放入頁面使用,或內嵌以用頁面的 token 來設定樣式。 - 當圖表需要放在元件內部時,可以手動建構:references/charts.md 中的配方是純 SVG 和 CSS,無任何依賴。
- 快速路徑:
- 檢查圖表:對照下面的檢查清單,並以實際將被觀看的大小來檢查。在 720 寬度下可讀的圖表,在 280 寬度下不見得可讀。
這不只是品味問題,而是規則
- 簡單的圖表不要用圖表函式庫。 四個長條加上一條折線只需要 30 行 SVG。一個函式庫佔用 40 到 120 KB,帶來需要覆寫的預設樣式,而且通常會輸出螢幕閱讀器無法讀取的 canvas。
- 不要用多種顏色來表示同一個數列。 一個強調色,一個主導的數列。一張圖表中超過三個數列,就應該拆成兩張圖表或改成一個表格。
- 顏色絕不能是唯一的信號。 使用直接標籤、位置或形狀差異。一張在灰階模式下失效的圖表,對每十二位男性中就有一位(色盲)是失效的。
- 文字是真實的文字。 使用 SVG
<text>,而不是路徑,這樣才能隨著讀者的設定縮放。不要將標籤嵌入圖片中。 - 尊重容器。 使用
viewBox加上width:100%、height:auto、max-width,以及一個當標籤無法容納時的min-width。在 375 寬度下,使用更少的刻度與更少的長條,而不是縮小整張圖表。 - 不要使用假資料。 如果數字只是佔位符,請在標題旁邊標明,並在報告中列出。
[需要:真實跑步次數]勝過一個看似合理的虛構數字。 - 單位與比較。 「47 次跑步」或「$48,210」,而不是「47」。任何變化都必須帶有比較對象:「+12% 與上個月相比」。
- 圖表有層級。 每張畫面只有一張主要的圖表,且明顯是最大的。如果出現另一張相同大小的圖表,代表兩者都不是重點。
檢查清單
- 圖表回答了一個明確的問題,且標題說明了該問題
- 圖表類型與問題匹配;沒有甜甜圈圖、沒有六塊的圓餅圖、沒有 3D、沒有雙 Y 軸
- 長條圖和堆疊長條圖從零開始;任何截斷的折線圖都有標明
- 重要的數列或數據點使用一個強調色;其他一切都是中性色
- 超過三個數列時,拆分為兩張圖表或一個表格
- 網格和座標軸低調,無圖表邊框,無陰影
- 標籤使用等寬數字,統一的數字格式,帶有單位
- 當有多個數列時提供圖例;只有一個數列時則不需要圖例
- 每個顯示變化的數值都帶有其比較對象
-
role="img"、<title>和<desc>以文字描述圖表顯示的內容 - 在 375 寬度和 200% 縮放下可讀;無任何元素被裁切,無標籤重疊
- 在灰階模式下可辨識;顏色不是區分數列的唯一方式
- 佔位資料在頁面中標明,並在報告中列出
- 數字可以追溯到一個可命名的來源
圖表類型對照表、常見但錯誤的圖表選擇,以及手動建構的 SVG 和 CSS 配方:references/charts.md。