vega

Vega / Vega-Lite 視覺化工具

快速入門： 將資料結構化為物件陣列 → 選擇標記類型（bar/line/point/area/arc/rect） → 將編碼（x, y, color, size）對應到欄位 → 設定資料類型（quantitative/nominal/ordinal/temporal） → 包在 ```vega-lite 或 ```vega 程式碼區塊中。務必包含 $schema，使用有效的 JSON 並以雙引號標註，欄位名稱區分大小寫。90% 的圖表使用 Vega-Lite；僅雷達圖、文字雲、力導向圖使用 Vega。

---

關鍵語法規則

規則 1：務必包含 Schema

"$schema": "https://vega.github.io/schema/vega-lite/v5.json"

規則 2：僅限有效 JSON

❌ {field: "x",}     → 結尾逗號、未加引號的鍵
✅ {"field": "x"}    → 正確的 JSON

規則 3：欄位名稱必須與資料相符

❌ "field": "Category"  但資料中為 "category"
✅ "field": "category"  → 區分大小寫的比對

規則 4：類型必須有效

✅ quantitative | nominal | ordinal | temporal
❌ numeric | string | date

---

常見問題

問題	解決方法
圖表未顯示	檢查 JSON 有效性，確認 $schema
資料未出現	欄位名稱必須完全相符
圖表類型錯誤	將標記對應到資料結構
顏色未顯示	檢查顏色比例尺的對比度
雙軸問題	加入 resolve: {scale: {y: "independent"}}

---

輸出格式

```vega-lite
{...}
```

或使用完整 Vega：

```vega
{...}
```

---

相關檔案

如需進階圖表模式與複雜視覺化，請參考以下文件：

• examples.md — 堆疊長條圖、分組長條圖、多序列折線圖、區域圖、熱力圖、雷達圖（Vega）、文字雲（Vega）與互動圖表範例