
有些場景只需要一條迷你折線、一條長條或一個小圓餅,不需要完整的圖表引擎。peity.js 就是為這種需求而生:它把頁面上一段用逗號分隔的文字(例如 <span>5,3,9,6,5</span>)轉換成 SVG 或 canvas 圖形,體積小、接入成本低。
引入 jQuery 與 peity 之後,選取元素並呼叫 peity(),第一個參數是圖表類型(bar / line / pie / donut),第二個參數是設定:
<script type="text/javascript" src="jQuery.js"></script> <script type="text/javascript" src="jquery.peity.js"></script>
jQuery(function(){
$(".bar-colours-1").peity("bar", {
colours: ["red", "green", "blue"],
width: 100, height: 100
});
});
colours 除了傳陣列,也可以傳一個函式,依數值正負決定顏色,很適合表現盈虧、增減這類語意:
$(".bar-colours-2").peity("bar", {
colours: function(value) {
return value > 0 ? "green" : "red"
},
width: 100, height: 100
});
函式版本同時能拿到索引與全部資料,於是可以用比例算出漸層:
$(".bar-colours-3").peity("bar", {
colours: function(_, i, all) {
var g = parseInt((i / all.length) * 255)
return "rgb(255, " + g + ", 0)"
},
width: 100, height: 100
});
$(".pie-colours-1").peity("pie", {
colours: ["cyan", "magenta", "yellow", "black"],
diameter: 100
});
因為資料來源就是元素的文字內容,所以只要改文字再觸發 change,圖表就會重畫。搭配 setInterval 就能做出滾動更新的走勢圖:
var updatingChart = $(".updating-chart").peity("line", { width: 150, height: 50 })
setInterval(function() {
var random = Math.round(Math.random() * 10)
var values = updatingChart.text().split(",")
values.shift() // 丟掉最舊的一筆
values.push(random) // 補上最新的一筆
updatingChart
.text(values.join(","))
.change()
}, 1000)
<span class="bar-colours-1">5,3,9,6,5,9,7,3,5,2</span> <span class="bar-colours-2">5,3,2,-1,-3,-2,2,3,5,2</span> <span class="bar-colours-3">0,-3,-6,-4,-5,-4,-7,-3,-5,-2</span> <br /> <span class="pie-colours-1">4,7,6,5</span> <span class="pie-colours-2">5,3,9,6,5</span> <br /> <span class="updating-chart">5,3,9,6,5,9,7,3,5,2,5,3,9,6,5,9,7,3,5,2</span>
小結一下:peity 的資料契約就是「逗號分隔的文字」,所以後端只要輸出字串、前端只要更新文字,圖表自然同步。這種設計在報表卡片、儀表板的小圖(sparkline)上特別省事。