專案裡需要把數據視覺化,先前收集不用的圖表外掛終於派上用場。不過實際接起來才發現,jqChart 的預設行為和想要的樣子有不少落差,得動一些手腳。
成品如下:

預設會畫上標題、Y 軸刻度數字與 X 軸分類文字,但我們想要的是一個乾淨的呈現,所以把這幾個區塊的建立程式碼註解掉:
// 各 DIV 的建立
// 取消標題顯示
/* this.titleBox // Title
= this.mkBoxElement('T', this.op.titleLeft, this.op.titleTop)
.appendTo(this.jQcanvasBox)
.css('width', this.op.width - this.op.titleLeft)
.get(0); */
// 取消 Y 軸數字顯示
/* this.scaleYBox // Y軸スケール
= this.mkBoxElement('Y', this.op.scaleYLeft, this.op.scaleYTop)
.appendTo(this.jQcanvasBox).get(0); */
// 取消 X 軸分類文字顯示
/* this.scaleXBox // X軸スケール
= this.mkBoxElement('X', this.op.scaleXLeft, this.op.scaleXTop)
.appendTo(this.jQcanvasBox).get(0); */
原本每個資料點上顯示的是數值,但需求是顯示對應的分類名稱:
if (x <= op.width) {
var dx = x - op.paddingL, dy = y - op.paddingT;
// 依序數決定 x 軸偏移,避免標籤互相重疊
var dxx = i <= 0 ? (dx + op.labelDataOffsetX - 5 + 'px')
: (dx + op.labelDataOffsetX - 20 + 'px');
// y 軸偏移,奇偶數交錯
var dyy = i % 2 ? (dy + op.labelDataOffsetY - 25 + 'px')
: (dy + op.labelDataOffsetY - 5 + 'px');
it.wrtText(
dxx,
dyy,
op.txtpointers[i], // 原本是 op.rows[i](數值),改為分類文字
op,
"#jQchart-data-D-" + op.id
)
.css('color', (op.data.length == 1) ? '#333' : strokeStyle)
.css({ "width": "100px", "font-size": "12px" });
}
這裡做了兩件事:把文字來源從 rows(數值)換成 txtpointers(分類名稱),並用 i % 2 讓相鄰標籤上下交錯,同時依位置微調偏移量,避免長文字彼此壓住。
有了靜態資料能顯示之後,接下來要能動態取得。這裡準備一個回傳 JSON 的資料頁 chartdata.html:
[{labelX : ["外觀設計","便攜性","易用性","電池待機","攝像功能","變焦"], data : [[5,7,2,3,9,4]]}]
前台用 ajax 請求該頁,處理回傳的資料後傳給 chartSetting:
$(function () {
$.ajax({
url: "chartdata.html",
type: "GET",
success: function (cdata) {
showDDChart(cdata);
}
});
function showDDChart(cdata) {
var dd_chart = eval(cdata)[0];
var chartSetting = {
config: {
title: "",
titleLeft: 70,
labelX: dd_chart.labelX,
scaleY: { min: 0, max: 10, gap: 2 },
width: 300 + 25,
height: 125 + 50,
paddingL: 10,
paddingT: 10
},
data: dd_chart.data
};
$('#canvasMyID').jQchart(chartSetting);
}
});
這裡的 eval(cdata) 應該換成 JSON.parse(cdata)。兩者對合法 JSON 的效果相同,但 eval 會執行字串中的任意程式碼,若資料來源不是百分之百可信(例如來自使用者輸入或第三方服務),就是一個明確的 XSS 入口。同時建議在 ajax 設定裡加上 dataType: "json",讓 jQuery 先幫你解析好。
<head>
<!--[if IE]>
<script src="excanvas-compressed.js" type="text/javascript"></script>
<![endif]-->
<script src="https://jsgt.org/lib/jquery/plugin/jqchart/sample/v003/lib/jquery-1.2.3.min.js" type="text/javascript"></script>
<script src="jquery.jqchart.js" type="text/javascript" charset="utf-8"></script>
</head>
<body>
<canvas id="canvasMyID" height="200"></canvas>
<script type="text/javascript">
$(function () {
$.ajax({
url: "chartdata.html",
type: "GET",
dataType: "json",
success: function (cdata) {
showDDChart(cdata);
}
});
function showDDChart(cdata) {
var dd_chart = cdata[0];
var chartSetting = {
config: {
title: "",
titleLeft: 70,
labelX: dd_chart.labelX,
scaleY: { min: 0, max: 10, gap: 2 },
width: 300 + 25,
height: 125 + 50,
paddingL: 10,
paddingT: 10
},
data: dd_chart.data
};
$('#canvasMyID').jQchart(chartSetting);
}
});
</script>
</body>
</html>
大功告成。整體流程是:改寫外掛的繪製邏輯以符合版面需求,把資料來源抽成一個可透過 ajax 取得的端點,再在成功回呼中組出設定物件交給外掛。這個「渲染與資料分離」的結構,之後要換資料來源或改成即時更新都很容易。