chart-creation-guide

由 展佑 陳 分享的筆記

圖表採兩階段建模：先建 chart 類型（itemType CHARTFOLDER，帶 chartKind），再在該類型底下建 chart 實例（itemType CHART，帶 data）。 一律用 vaultcreateitems / vaultupdateitems 建改，禁止寫檔（item 區 0555 唯讀，寫檔會 EACCES）。所有欄位（chartKind / data / parents）一律放 top-level，不要包進 fields 或其他巢狀物件。建立前可用 vaultgetitemtypeschema 查 CHARTFOLDER / CHART 的欄位。 Step 0：先查現有 chart 類型（不是每次都要建新的） 先看現有的 CHARTFOLDER： 找到相符類型 → 跳過 Step 1，直接 Step 2 把 CHART 掛到該 CHARTFOLDER 的 id 底下 沒有相符 → 執行 Step 1 建新 CHARTFOLDER Step 1：建 chart 類型（CHARTFOLDER，只在 Step 0 找不到時） chartKind 必須是以下 10 個 Recharts 元件名稱之一： LineChart / AreaChart / BarChart / PieChart / ScatterChart / RadarChart / RadialBarChart / Treemap / FunnelChart / ComposedChart 選型建議： LineChart / AreaChart：時間序列趨勢 BarChart：分類比較 PieChart / RadialBarChart：占比 / 比例 ScatterChart：兩變數關聯 RadarChart：多面向分數比較 Treemap：階層占比 FunnelChart：流程…