Dashboard utility, based on @plotdb/block.
一份 def 描述整個儀表板(資料來源、每一格畫什麼、版面、主題),dash.board 把它掛起來,
並負責 panel 的生命週期與跨圖篩選(crossfilter)。畫圖的是 @plotdb/chart 系的圖表 block,
dash 不碰繪圖。
npm install @plotdb/dash
走 fedep 的專案在 package.json 的 frontendDependencies.modules 加上 @plotdb/dash,
npx fedep 之後頁面上載這兩個檔:
/assets/lib/@plotdb/dash/main/index.min.js # 掛出全域的 window.dash
/assets/lib/@plotdb/dash/main/index.min.css # 版面與卡片的基本 CSS
這兩個檔在套件根目錄。repo 裡它們在 dist/,fedep publish 發佈時會攤平到根目錄。
不要指 web/static/ 底下的任何東西——那是 dev server 編給示範頁用的,不進版控也不發佈。
const board = new dash.board({
root: document.querySelector('#board'),
manager: blockManager, // @plotdb/block 的 manager
def: {
data: {...}, // 資料來源與欄位
layout: {type: 'grid', columns: 12},
theme: {name: 'desk', mode: 'auto'},
panels: [
{id: 'trend', title: '月銷售趨勢', area: [0, 0, 6, 4],
chart: {name: '@makechart/line'}, binding: {...}}
]
}
});
board.init();主要的 API:
board.init() / board.reload(def) |
掛起來 / 換一份 def |
board.setTheme(t) / board.setMode(m) |
換主題 / 換明暗,不清篩選 |
board.relayout(layout) |
只換版面,不重建 panel |
board.addPanel / updatePanel / removePanel |
單格增修刪 |
board.setFilter / toggleFilter / clearPanel |
篩選 |
dash.themes |
內建主題清單 |
內建七份主題:vanilla / desk / report / wall / terminal / pocket / rail。
doc/index.md—— def 的格式、版面、主題、build 的輸出npm start開示範站,web/src/pug/initiative/底下每個概念各有一份 README:variation/七種卡片設計(同一份 def,只換 panel block)theme/主題格式、標題列規格、操作提示怎麼推出來的split/可拖的巢狀版面
npm start # 示範站
npm run build # 編出 dist/
npm run release # build + 發佈(npm 與 GitHub release)
授權 MIT。