DIV CSS 佈局教程網

jqPlot 的 Option 設定物件全面詳解
編輯:JQuery特效代碼     

本文重點在於 jqPlot 的核心——Option 設定物件,同時也會對 jqPlot 的各種渲染器(renderer)做個簡要介紹。以下內容主要參考官方網站關於 Option 的說明,並結合個人實踐與理解進行詮釋,若有不妥或疏漏之處,歡迎指正。

以下是完整的 Option 設定範例:

options =
{
seriesColors: [ "#4bb2c5", "#c5b47f", "#EAA228", "#579575", "#839557", "#958c12",
"#953579", "#4b5de4", "#d8b83f", "#ff5800", "#0085cc"], // 預設顯示的分類顏色,
//如果分類的數量超過這裡的顏色數量,則從該隊列中第一個位置開始重新取值賦給相應的分類
stackSeries: false, // 如果置為 true 並且有多個分類(如果是折線圖,就必須多於一條折線),
// 那麼每個分類(折線)在縱軸上的值為其前所有分類縱軸值總和與其縱軸值相加值
title: '', //設置當前圖的標題
title: {
text: '', // 設置當前圖的標題
show: true,//設置當前標題是否顯示
},
axisDefaults: {
show: false, // wether or not to renderer the axis. Determined automatically.
min: null, // 橫(縱)坐標顯示的最小值
max: null, // 橫(縱)坐標顯示的最大值
pad: 1.2, // 一個相乘因子,(數據最大值-最小值)*pad=該軸顯示的區間長度
ticks: [], //設置橫(縱)坐標的刻度上的值
numberTicks: undefined, //一個相除因子,用於設置橫(縱)坐標刻度間隔
tickInterval:'', //橫(縱)坐標刻度間隔值,可為日期字符串
renderer: $.jqplot.LinearAxisRenderer, // 設置橫(縱)軸上數據加載的渲染器
rendererOptions: {}, // 設置 renderer 的 Option 配置對象
tickOptions: {
mark: 'outside', // 設置刻度顯示方式,'outside'、'inside' 和 'cross'
showMark: true, //設置是否顯示刻度
showGridLine: true, // 是否在圖表區域顯示刻度值方向的網格線
markSize: 4, // 每個刻度線頂點距刻度線在坐標軸上點距離(像素)
show: true, // 是否顯示刻度線、網格線以及刻度值
showLabel: true, // 是否顯示刻度線以及刻度值
formatString: '', // 設置坐標軸上刻度值顯示格式,eg:'%b %#d, %Y'
fontSize:'10px', //刻度值的字體大小
fontFamily:'Tahoma', //刻度值上字體
angle:40, //刻度值與坐標軸夾角
fontWeight:'normal', //字體的粗細
fontStretch:1//刻度值在所在方向上的伸展度
},
showTicks: true, // 是否顯示刻度線以及坐標軸上的刻度值
showTickMarks: true, //設置是否顯示刻度
useSeriesColor: true //如果有多個縱(橫)坐標軸,設置這些坐標軸是否以不同顏色顯示
},
axes: {
xaxis: { /* 設置同 axisDefaults */ },
yaxis: { /* 設置同 axisDefaults */ },
x2axis: { /* 設置同 axisDefaults */ },
y2axis: { /* 設置同 axisDefaults */ }
},
seriesDefaults: {//如果有多個分類,可透過該配置屬性設置各個分類的共性屬性
show: true, // 設置是否渲染整個圖表區域
xaxis: 'xaxis', // either 'xaxis' or 'x2axis'.
yaxis: 'yaxis', // either 'yaxis' or 'y2axis'.
label: '', // 用於顯示在分類名稱框中的分類名稱
color: '', // 分類在圖標中表示的顏色
lineWidth: 2.5, // 分類圖的寬度
shadow: true, // 各圖在圖表中是否顯示陰影區域
shadowAngle: 45, // 參考 grid 中相同參數
shadowOffset: 1.25, // 參考 grid 中相同參數
shadowDepth: 3, // 參考 grid 中相同參數
shadowAlpha: 0.1, // 參考 grid 中相同參數
showLine: true, //是否顯示圖表中的折線
showMarker: true, // 是否強調顯示圖中的數據節點
fill: false, // 是否填充圖表中折線下面的區域
fillAndStroke: false, //在 fill 為 true 時,於填充區域最上面顯示一條線
fillColor: undefined, // 設置填充區域的顏色
fillAlpha: undefined, // 設置填充區域的透明度
renderer: $.jqplot.PieRenderer, // 利用渲染器渲染現有圖表
rendererOptions: {}, // 傳給渲染器的 option 對象
markerRenderer: $.jqplot.MarkerRenderer, // renderer to use to draw the data point markers.
markerOptions: {
show: true, // 是否在圖中顯示數據點
style: 'filledCircle', // 數據點顯示方式,默認 filledCircle
lineWidth: 2, // 數據點邊的寬度
size: 9, // 數據點的大小
color: '#666666', // 數據點的顏色
shadow: true, // 是否為數據點顯示陰影區
shadowAngle: 45, // 陰影區角度
shadowOffset: 1, // 參考 grid 中相同參數
shadowDepth: 3, //參考 grid 中相同參數
shadowAlpha: 0.07 // 參考 grid 中相同參數
},
isDragable: true,//是否允許拖動(如果 dragable 包已引入),默認可拖動
},
series:[//如果有多個分類需要顯示,在此處設置各個分類的相關配置屬性
//配置參數設置同 seriesDefaults
],
legend: {
show: false,//設置是否出現分類名稱框
location: 'ne', // 分類名稱框出現位置, nw, n, ne, e, se, s, sw, w.
xoffset: 12, // 分類名稱框距圖表區域上邊框的距離(px)
yoffset: 12, // 分類名稱框距圖表區域左邊框的距離(px)
background:'', //分類名稱框背景色
textColor:'' //分類名稱框內字體顏色
},
grid: {
drawGridLines: true, // wether to draw lines across the grid or not.
gridLineColor: '#cccccc', // 設置網格背景線的顏色
background: '#fffdf6', // 設置整個圖表區域的背景色
borderColor: '#999999', // 設置圖表邊框的顏色
borderWidth: 2.0, //設置圖表邊框寬度
shadow: true, // 為整個圖標邊框設置陰影
shadowAngle: 45, // 設置陰影區域的角度
shadowOffset: 1.5, // 設置陰影區域偏移出圖片邊框的距離
shadowWidth: 3, // 設置陰影區域的寬度
shadowDepth: 3, // 設置陰影區域重疊陰影的數量
shadowAlpha: 0.07 // 設置陰影區域的透明度
renderer: $.jqplot.CanvasGridRenderer, // renderer to use to draw the grid.
rendererOptions: {} // options to pass to the renderer.
}

各外掛的 Option 設定

以下針對不同渲染器補充其專屬的設定物件。

// BarRenderer(柱狀圖)
seriesDefaults: {
rendererOptions: {
barPadding: 8, //同一分類兩個柱狀條之間的距離(px)
barMargin: 10, //不同分類的兩個柱狀條之間的距離(px)
barDirection: 'vertical', //柱狀圖方向:vertical 或 horizontal
barWidth: null, // 每個柱狀條的寬度
shadowOffset: 2, shadowDepth: 5, shadowAlpha: 0.8
}
},
// Cursor(光標)
cursor: {
style: 'crosshair', //鼠標顯示樣式
show: true, //是否顯示光標
showTooltip: true, // 是否顯示提示信息欄
followMouse: false, //提示信息欄是否隨鼠標移動
tooltipLocation: 'se', // 光標提示信息欄的位置
tooltipOffset: 6, //提示信息欄距鼠標或坐標軸的位置
showTooltipGridPosition: false,//是否顯示光標位置的像素距離
showTooltipUnitPosition: true,// 是否顯示光標所在位置的數據值
tooltipFormatString: '%.4P',
useAxesFormatters: true,
tooltipAxesGroups: []
},
// Dragable(拖動)
seriesDefaults: {
dragable: {
color: undefined, // 拖動線與拖動數據點顏色
constrainTo: 'none', //拖動范圍: 'x'、'y' 或 'none'
},
},
// Highlighter(高亮)
highlighter: {
lineWidthAdjust: 2.5, //放大數據點的寬度
sizeAdjust: 5, // 數據點擴大的增量
showTooltip: true, // 是否顯示提示信息欄
tooltipLocation: 'nw', // 提示信息顯示位置
fadeTooltip: true, // 提示信息欄是否淡入淡出
tooltipFadeSpeed: "fast", // 淡入淡出速度
tooltipOffset: 2, // 提示信息欄的偏移位置
tooltipAxes: 'both', // x, y or xy
tooltipSeparator: ', ', // 不同值之間的間隔符號
useAxesFormatters: true,
tooltipFormatString: '%.5P'
},
// LogAxisRenderer(指數渲染器)
axesDefaults: {
base: 10, // 指數的底數
tickDistribution: 'even', // 'even' 或 'power'
},
// PieRenderer(餅狀圖)
seriesDefaults: {
rendererOptions: {
diameter: undefined, // 餅的直徑
padding: 20, // 餅距分類名稱框或圖表邊框的距離
sliceMargin: 20, // 餅每個部分之間的距離
fill:true, // 餅每部分是否填充
shadow:true, // 為餅每部分的邊框設置陰影
shadowOffset: 2, shadowDepth: 5, shadowAlpha: 0.07
}
},
// pointLabels(數據點標簽)
seriesDefaults: {
pointLabels: {
location:'s',//數據標簽顯示方位
ypadding:2 //數據標簽距數據點在縱軸方向上的距離
}
},
// Trendline(趨勢線)
seriesDefaults: {
trendline: {
show: true, // 是否顯示趨勢線
color: '#666666', // 趨勢線顏色
label: '', // 趨勢線名稱
type: 'linear', //'linear'、'exponential' 或 'exp'
shadow: true, lineWidth: 1.5,
shadowAngle: 45, shadowOffset: 1.5, shadowDepth: 3, shadowAlpha: 0.07
}
}

相關渲染器介紹

1. dateAxisRenderer
引用:<script type="text/javascript" src="../plugins/jqplot.dateAxisRenderer.min.js" />
用於顯示刻度為日期格式的坐標軸,幾乎支援所有日期格式,並能把日期字串格式化後顯示於刻度線上。

2. categoryAxisRenderer
引用:<script type="text/javascript" src="../plugins/jqplot.categoryAxisRenderer.min.js" />
將刻度處的值顯示於兩個刻度之間,代表某個范圍內的值,適合與柱狀圖搭配使用。

3. barRenderer
引用:<script type="text/javascript" src="../plugins/jqplot.barRenderer.min.js" />
用於顯示柱狀圖,能精細控制組內及組間距離,並支援水平顯示。

4. cursor
引用:<script type="text/javascript" src="../plugins/jqplot.cursor.min.js" />
控制鼠標移到圖中時的顯示形式,常與高亮功能搭配,引用後立即生效。

5. highlighter
引用:<script type="text/javascript" src="../plugins/jqplot.highlighter.min.js" />
鼠標移到數據點上時顯示提示欄,預設顯示橫縱坐標軸刻度值,內容可依需求自訂。

6. logAxisRenderer
引用:<script type="text/javascript" src="../plugins/jqplot.logAxisRenderer.min.js" />
以指數計算方式生成坐標軸刻度值,可均勻顯示,也可按指數增長顯示。

7. ohlcRenderer
引用:<script type="text/javascript" src="../plugins/jqplot.ohlcRenderer.min.js" />
用於顯示甘特圖,通常與 dateAxisRenderer 一起使用。

8. dragable
引用:<script type="text/javascript" src="../plugins/jqplot.dragable.min.js" />
讓用戶能拖動數據點,圖表會自動重畫,數據值也隨拖動改變。

9. trendline
引用:<script type="text/javascript" src="../plugins/jqplot.trendline.min.js" />
對現有數據做線性回歸計算,並以趨勢線呈現,拖動數據點時趨勢線亦隨之變化。

10. pointLabels
引用:<script type="text/javascript" src="../plugins/jqplot.pointLabels.min.js" />
把數據節點的相關資訊以標簽形式置於節點附近;數據為空時標簽不顯示。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved