jqPlot 是一款相當出色的基於 jQuery 的圖表插件,本文整理了它的中文使用說明、常用屬性選項與源碼下載。在支援 HTML5 的瀏覽器上,jqPlot 會以 canvas 呈現圖表。
jqPlot 需要 jQuery 1.4.3 以上版本。若在 IE9 以下的瀏覽器使用,還需引入 excanvas.js,同時別忘了引入 CSS 檔:
<!--[if lt IE 9]><script language="javascript" type="text/javascript" src="excanvas.js"></script><![endif]--> <script language="javascript" type="text/javascript" src="jquery.min.js"></script> <script language="javascript" type="text/javascript" src="jquery.jqplot.min.js"></script> <link rel="stylesheet" type="text/css" href="jquery.jqplot.css" />
在頁面上為 jqPlot 準備一個容器(如 div),注意要指定寬高:
<div id="chartdiv" style="height:400px;width:300px; "></div>
透過呼叫 $.jqplot 實現圖表的生成與渲染:
$.jqplot('chartdiv', [[[1, 2],[3,5.12],[5,13.1],[7,33.6],[9,85.9],[11,219.9]]]);
最終顯示效果如下圖:
呼叫 $.jqplot 時可傳入 options 自訂圖表,部分常用參數如下:
seriesColors: [ "#4bb2c5", "#c5b47f", "#EAA228", "#579575", "#839557", "#958c12",
"#953579", "#4b5de4", "#d8b83f", "#ff5800", "#0085cc"], // 默認顯示的分類顏色
stackSeries: false, // 如果置為true並且有多個分類,每個分類在縱軸上的值為其前所有分類縱軸值總和與其縱軸值相加值
title: '', //設置當前圖的標題
axesDefaults: {
show: false, //是否自動顯示坐標軸
min: null, //橫(縱)軸最小刻度值
max: null, //橫(縱)軸最大刻度值
pad: 1.2, //橫(縱)軸度值增漲因子
ticks: [], //設置橫(縱)坐標的刻度上的值
numberTicks: undefined, //一個相除因子,用於設置刻度間隔
renderer: $.jqplot.LinearAxisRenderer, //設置橫(縱)軸上數據加載的渲染器
tickOptions: {
mark: 'outside', //刻度在坐標軸上的顯示方式
showMark: true, //設置是否顯示刻度
showGridline: true, //是否在圖表區域顯示刻度值方向的網格
show: true, //是否顯示刻度線及刻度值
formatString: '', //設置坐標軸上刻度值顯示格式
fontSize:'10px', //刻度值的字體大小
fontFamily:'Tahoma', //刻度值上字體
angle:40, //刻度值與坐標軸夾角
}
showTicks: true, //是否顯示刻度線以及刻度值
showTickMarks: true, //設置是否顯示刻度
useSeriesColor: true //如果有多個縱(橫)坐標軸,是否以不同顏色顯示
},
seriesDefaults: { //如果有多個分類,可通過該配置設置各分類的共性屬性
show: true, //設置是否渲染整個圖表區域
label: '', //用於顯示在分類名稱框中的分類名稱
color: '', //分類在圖標中表示的顏色
lineWidth: 2.5, //分類圖的寬度
shadow: true, //各圖在圖表中是否顯示陰影區域
showLine: true, //是否顯示圖表中的折線
showMarker: true, //是否強調顯示圖中的數據節點
fill: false, //是否填充圖表中折線下面的區域
renderer: $.jqplot.PieRenderer, //利用渲染器渲染現有圖表,從而轉換成所需圖表
markerOptions: {
show: true, //是否在圖中顯示數據點
style: 'filledCircle', //各個數據點顯示方式
size: 9, //數據點的大小
color: '#666666' //數據點的顏色
}
},
legend: {
show: false, //設置是否出現分類名稱框
location: 'ne', //分類名稱框出現位置: nw, n, ne, e, se, s, sw, w
xoffset: 12, //距圖表區域上邊框的距離
yoffset: 12, //距圖表區域左邊框的距離
},
grid: {
drawGridLines: true, //是否畫網格線
gridLineColor: '#cccccc', //設置網格背景線的顏色
background: '#fffdf6', //設置圖表區域的背景色
borderColor: '#999999', //設置圖表邊框的顏色
borderWidth: 2.0, //設置圖表邊框寬度
shadow: true, //為邊框設置陰影
}
此外還可針對 BarRenderer(柱狀圖)、Cursor(光標)、Dragable(拖動)、Highlighter(高亮)、PieRenderer(餅狀圖)、pointLabels(數據點標籤)、Trendline(趨勢線)等各類插件進行細緻的 Option 配置。
$.jqplot('chartdiv', [[[1, 2],[3,5.12],[5,13.1],[7,33.6],[9,85.9],[11,219.9]]],
{ title:'Exponential Line',
axes:{yaxis:{min:-10, max:240}},
series:[{color:'#5FAB78'}]
});
顯示效果如下:
其官方網站為:https://www.jqplot.com/。