jqPlot Option配置对象详解


Posted in Javascript onJuly 25, 2009

这里主要介绍jqPlot中核心部分——Option配置对象。同时,也会对jqplot的各个渲染器做个简单介绍。
这里主要是参考jqPlot官方网站关于Option的介绍并结自己简单实践和理解来对Option的相关属性进行解释,如有不合适或错误的地方请指正。

options = 
{ 
seriesColors: [ "#4bb2c5", "#c5b47f", "#EAA228", "#579575", "#839557", "#958c12", 
"#953579", "#4b5de4", "#d8b83f", "#ff5800", "#0085cc"], // 默认显示的分类颜色, 
//如果分类的数量超过这里的颜色数量,则从该队列中第一个位置开始重新取值赋给相应的分类 
stackSeries: false, // 如果置为true并且有多个分类(如果是折线图,就必须多于一条折线), 
// 那么每个分类(折线)在纵轴上的值为其前所有分类纵轴值总和与其纵 
//轴值相加值(eg,当前分类纵轴值为Y3 
//,其前有Y2,Y1,那么他显示在Y轴上值为Y2+Y3+Y1,目前该属性支持线图和柱状图 
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值=该轴显示的横(纵)坐标区间长度 
// 该轴显示的横(纵)坐标区间长度=横(纵)坐标显示的最大值-横(纵)坐标显示的最小值 
//如果设置了max和min的值的话,那么会优先考虑min和max设置的值 
ticks: [], //设置横(纵)坐标的刻度上的值,可为该ticks数组中的值, 
// a 1D [val1, val2, ...], or 2D [[val, label], [val, label], ...] 
numberTicks: undefined, //一个相除因子,用于设置横(纵)坐标刻度间隔 
//横(纵)坐标刻度间隔值=横(纵)坐标区间长度/(numberTicks-1) 
tickInterval:'', //横(纵)坐标刻度间隔值,可为日期字符串 
renderer: $.jqplot.LinearAxisRenderer, // 设置横(纵)轴上数据加载的渲染器,有dateAxisRenderer(参见本文最后相关介绍) 。 
rendererOptions: {}, // 设置renderer的Option配置对象,线状图不需要设置 
//不同图表的Option配置对象请参见下面《jqPlot各个不同插件的Option对象设置》 
//中各个图表的配置Option对象 
tickOptions: { 
mark: 'outside', // 设置横(纵)坐标刻度在坐标轴上显示方式,分为坐标轴内,外,穿过坐标轴显示 
// 值也分为:'outside', 'inside' 和 'cross', 
showMark: true, //设置是否显示刻度 
showGridLine: true, // 是否在图表区域显示刻度值方向的网格线 
markSize: 4, // 每个刻度线顶点距刻度线在坐标轴上点距离(像素为单位) 
//如果mark值为 'cross', 那么每个刻度线都有上顶点和下顶点,刻度线与坐标轴 
//在刻度线中间交叉,那么这时这个距离×2, 
show: true, // 是否显示刻度线,与刻度线同方向的网格线,以及坐标轴上的刻度值 
showLabel: true, // 是否显示刻度线以及坐标轴上的刻度值 
formatString: '', // 梃置坐标轴上刻度值显示格式,eg:'%b %#d, %Y'表示格式"月 日,年","AUG 30,2008" 
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, // 是否填充图表中折线下面的区域(填充颜色同折线颜色)以及legend 
//设置的分类名称框中分类的颜色,此处注意的是如果fill为true, 
//那么showLine必须为true,否则不会显示效果 
fillAndStroke: false, //在fill为true的状态下,在填充区域最上面显示一条线(如果是折线图则显示该折线) 
fillColor: undefined, // 设置填充区域的颜色 
fillAlpha: undefined, // 梃置填充区域的透明度 
renderer: $.jqplot.PieRenderer, // 利用渲染器(这里是利用饼图PieRenderer)渲染现有图表 
//,从而转换成所需图表 
rendererOptions: {}, // 传给上个属性所设置渲染器的option对象,线状图的渲染器没有option对象, 
//不同图表的Option配置对象请参见下面《jqPlot各个不同插件的Option对象设置》 
//中各个图表的配置Option对象 
markerRenderer: $.jqplot.MarkerRenderer, // renderer to use to draw the data 
// point markers. 
markerOptions: { 
show: true, // 是否在图中显示数据点 
style: 'filledCircle', // 各个数据点在图中显示的方式,默认是"filledCircle"(实心圆点), 
//其他几种方式circle,diamond, square, filledCircle, 
// filledDiamond or filledSquare. 
lineWidth: 2, // 数据点各个的边的宽度(如果设置过大,各个边会重复,会显示的类似于实心点) 
size: 9, // 数据点的大小 
color: '#666666' // 数据点的颜色 
shadow: true, // 是否为数据点显示阴影区(增加立体效果) 
shadowAngle: 45, // 阴影区角度,x轴顺时针方向 
shadowOffset: 1, // 参考grid中相同参数 
shadowDepth: 3, //参考grid中相同参数 
shadowAlpha: 0.07 // 参考grid中相同参数 
} 
isDragable: true,//是否允许拖动(如果dragable包已引入),默认可拖动 
}, 
series:[//如果有多个分类需要显示,这在此处设置各个分类的相关配置属性 
//eg.设置各个分类在分类名称框中的分类名称 
//[label: 'Traps Division'},{label: 'Decoy Division'},{label: 'Harmony Division'}] 
//配置参数设置同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, // 设置阴影区域的角度,从x轴顺时针方向旋转 
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. Note, the default 
// CanvasGridRenderer takes no additional options. 
}, 
/************************jqPlot各个不同插件的Option对象设置******************************/ 
// BarRenderer(设置柱状图的Option对象) 
//该Option对象适用与柱状图的series和seriesDefault属性的相关配置对象设置 
seriesDefaults: { 
rendererOptions: { 
barPadding: 8, //设置同一分类两个柱状条之间的距离(px) 
barMargin: 10, //设置不同分类的两个柱状条之间的距离(px)(同一个横坐标表点上) 
barDirection: 'vertical', //设置柱状图显示的方向:垂直显示和水平显示 
//,默认垂直显示 vertical or horizontal. 
barWidth: null, // 设置柱状图中每个柱状条的宽度 
shadowOffset: 2, // 同grid相同属性设置 
shadowDepth: 5, // 同grid相同属性设置 
shadowAlpha: 0.8, // 同grid相同属性设置 
} 
}, 
// Cursor(光标) 
// 鼠标移动到图中时,鼠标在图中显示形式,常与和高亮功能同时使用 
//此外,通过设置该属性的zoom相关属性来对图中某个区域钻取(就选定区域放大) 
//该配置对象直接在option下配置 
cursor: { 
style: 'crosshair', //当鼠标移动到图片上时,鼠标的显示样式,该属性值为css类 
show: true, //是否显示光标 
showTooltip: true, // 是否显示提示信息栏 
followMouse: false, //光标的提示信息栏是否随光标(鼠标)一起移动 
tooltipLocation: 'se', // 光标提示信息栏的位置设置。如果followMouse=true,那么该位置为 
//提示信息栏相对于光标的位置。否则,为光标提示信息栏在图标中的位置 
// 该属性可选值: n, ne, e, se, etc. 
tooltipOffset: 6, //提示信息栏距鼠标(followMouse=true)或坐标轴(followMouse=false)的位置 
showTooltipGridPosition: false,//是否在信息提示栏中显示光标位置(取其据图标左和上边缘线像素距离) 
showTooltipUnitPosition: true,// 是否显示提示光标所在位置(取其在横纵轴上数据值)的信息栏 
//注:注意此处与showTooltipGridPosition值区别,前者显示坐标值,该处显示的是数据值 
tooltipFormatString: '%.4P', // 同Highlighter的tooltipFormatString 
useAxesFormatters: true, // 同Highlighter的tooltipFormatString 
tooltipAxesGroups: [], // show only specified axes groups in tooltip. Would specify like: 
// [['xaxis', 'yaxis'], ['xaxis', 'y2axis']]. By default, all axes 
// combinations with for the series in the plot are shown. 
}, 
// Dragable(拖动) 
//该配置对象通过seriesDefaults和series配置对象进行配置 
seriesDefaults: { 
dragable: { 
color: undefined, // 当拖动数据点是,拖动线与拖动数据点颜色 
constrainTo: 'none', //设置拖动的的范围: 'x'(只能在横向上拖动), 
// 'y'(只能在纵向上拖动), or 'none'(无限制). 
}, 
}, 
// Highlighter(高亮) 
//设置高亮动作option属性对象 
//鼠标移动到某个数据点上时,该数据点增大并显示提示信息框 
//该配置对象直接在option下配置 
highlighter: { 
lineWidthAdjust: 2.5, //当鼠标移动到放大的数据点上时,设置增大的数据点的宽度 
// 目前仅适用于非实心数据点 
sizeAdjust: 5, // 当鼠标移动到数据点上时,数据点扩大的增量增量 
showTooltip: true, // 是否显示提示信息栏 
tooltipLocation: 'nw', // 提示信息显示位置(英文方向的首写字母): n, ne, e, se, s, sw, w, nw. 
fadeTooltip: true, // 设置提示信息栏出现和消失的方式(是否淡入淡出) 
tooltipFadeSpeed: "fast"//设置提示信息栏淡入淡出的速度: slow, def, fast, 或者是一个毫秒数的值. 
tooltipOffset: 2, // 提示信息栏据被高亮显示的数据点的偏移位置,以像素计。 
tooltipAxes: 'both', // 提示信息框显示数据点那个坐标轴上的值,目前有横/纵/横纵三种方式。 
//值分别为 x, y or xy. 
tooltipSeparator: ', ' // 提示信息栏不同值之间的间隔符号 
useAxesFormatters: true // 提示信息框中数据显示的格式是否和该数据在坐标轴上显示格式一致 
tooltipFormatString: '%.5P' // 用于设置提示信息框中数据显示的格式,前提条件是useAxesFormatters 
// 为false. 此时信息提示框中数据格式不再与坐标轴一致,而是以此为准 
//同时,该属性还支持html格式字符串 
//eg:'<b><i><span style="color:red;">hello</span></i></b> %.2f' 
}, 
// LogAxisRenderer(指数渲染器) 
// 该渲染器只有两个属性, 指数渲染器通过axesDefaults和axes配置对象进行配置 
axesDefaults: { 
base: 10, // 指数的底数 
tickDistribution: 'even', // 坐标轴显示方式:'even' or 'power'. 'even' 产生的是均匀分布于坐标 
//轴上的坐标刻度值 。而'power' 则是根据不断增大的增数来确定坐标轴上的刻度 
}, 
// PieRenderer(设置饼状图的OPtion对象) 
// 饼状图通过seriesDefaults和series配置对象进行配置 
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和series配置对象进行配置 
seriesDefaults: { 
trendline: { 
show: true, // 是否显示趋势线 
color: '#666666', // 趋势线颜色 
label: '', // 趋势线名称 
type: 'linear', //趋势线类型'linear'(直线), 'exponential'(幂值数线) or 'exp' 
shadow: true, // 同grid相同属性设置 
lineWidth: 1.5, // 趋势线宽度 
shadowAngle: 45, // 同grid相同属性设置 
shadowOffset: 1.5, // 同grid相同属性设置 
shadowDepth: 3, // 同grid相同属性设置 
shadowAlpha: 0.07 // 同grid相同属性设置 
} 
} 
}

相关渲染器介绍
1.dateAxisRenderer 
相关引用包:<script type="text/javascript" src="../plugins/jqplot.dateAxisRenderer.min.js" /> 
该渲染器主要用于显示刻度为日期格式的坐标轴,它增强了javascript的本地数据处理能力,它几乎支持所有的日期格式。 
另外,该渲染器还提供了强大的格式化功能,它能将数据中日期字符串格式化为你需要的格式并显示在坐标轴的刻度线上。 
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" /> 
通过该渲染器,用户能够拖动某个数据点,jqplot会自动重画拖动后的新图表。同时,被拖动的数据点的数据值也随着拖动发生变化。 
9.trendline 
相关引用包:<script type="text/javascript" src="../plugins/jqplot.trendline.min.js" /> 
该渲染器主要用于对现有数据进行线性回归计算,并自动将计算结果以趋势线的形式展示出来,当用户拖动某个数据点时,趋势线亦随用户拖动而变化。 
10.pointLabels 
相关引用包:<script type="text/javascript" src="../plugins/jqplot.pointLabels.min.js" /> 
该渲染器主要用于将数据节点相关的的信息以标签的方式放于该数据节点附近;对于相应数据为空的,其标签不显示。
Javascript 相关文章推荐
jquery对象和DOM对象的区别介绍
Aug 09 Javascript
Javascript 鼠标移动上去 滑块跟随效果代码分享
Nov 23 Javascript
JavaScript学习笔记之定时器
Jan 22 Javascript
jQuery禁用快捷键例如禁用F5刷新 禁用右键菜单等的简单实现
Aug 31 Javascript
jQuery的ready方法实现原理分析
Oct 26 Javascript
js复制内容到剪贴板代码,js复制代码的简单实例
Oct 27 Javascript
图解Javascript——作用域、作用域链、闭包
Mar 21 Javascript
AngularJS折叠菜单实现方法示例
May 18 Javascript
vue-cli中打包图片路径错误的解决方法
Oct 26 Javascript
vue-cli2.0转3.0之项目搭建的详细步骤
Dec 11 Javascript
浅谈JavaScript节流和防抖函数
Aug 25 Javascript
在实例中重学JavaScript事件循环
Dec 03 Javascript
jqPlot jquery的页面图表绘制工具
Jul 25 #Javascript
IE DOM实现存在的部分问题及解决方法
Jul 25 #Javascript
从父页面读取和操作iframe中内容方法
Jul 25 #Javascript
javaScript 数值型和字符串型之间的转换
Jul 25 #Javascript
JavaScript中null与undefined分析
Jul 25 #Javascript
js 字符串操作函数
Jul 25 #Javascript
javaScript Array(数组)相关方法简述
Jul 25 #Javascript
You might like
PHP 函数执行效率的小比较
2010/10/17 PHP
php的memcached客户端memcached
2011/06/14 PHP
php+ajax做仿百度搜索下拉自动提示框(有实例)
2012/08/21 PHP
解析关于java,php以及html的所有文件编码与乱码的处理方法汇总
2013/06/24 PHP
使用PHP和HTML5 FormData实现无刷新文件上传教程
2014/09/06 PHP
php实现按天数、星期、月份查询的搜索框
2016/05/02 PHP
Laravel 批量更新多条数据的示例
2017/11/27 PHP
PHP+MySQL实现在线测试答题实例
2020/01/02 PHP
JQuery以JSON方式提交数据到服务端示例代码
2014/05/05 Javascript
获取中文字符串的实际长度代码
2014/06/05 Javascript
JavaScript调用客户端Java程序的方法
2015/07/27 Javascript
跟我学习javascript的隐式强制转换
2015/11/16 Javascript
在 Express 中使用模板引擎
2015/12/10 Javascript
Jq通过td获取同行其它列td的方法
2016/10/05 Javascript
JavaScript实现垂直向上无缝滚动特效代码
2016/11/23 Javascript
Bootstrap 模态框(Modal)插件代码解析
2016/12/21 Javascript
React如何利用相对于根目录进行引用组件详解
2017/10/09 Javascript
nodejs遍历文件夹下并操作HTML/CSS/JS/PNG/JPG的方法
2018/11/01 NodeJs
详解javascript 变量提升(Hoisting)
2019/03/12 Javascript
JS前端知识点offset,scroll,client,冒泡,事件对象的应用整理总结
2019/06/27 Javascript
easyUI 实现的后台分页与前台显示功能示例
2020/06/01 Javascript
python实现的udp协议Server和Client代码实例
2014/06/04 Python
python&amp;MongoDB爬取图书馆借阅记录
2016/02/05 Python
Python+selenium实现自动循环扔QQ邮箱漂流瓶
2018/05/29 Python
线程安全及Python中的GIL原理分析
2019/10/29 Python
Django-rest-framework中过滤器的定制实例
2020/04/01 Python
pycharm激活方法到2099年(激活流程)
2020/09/22 Python
python 爬虫之selenium可视化爬虫的实现
2020/12/04 Python
python 基于selenium实现鼠标拖拽功能
2020/12/24 Python
英国领先的亚洲旅游专家:Wendy Wu Tours
2018/01/21 全球购物
香港连卡佛百货官网:Lane Crawford
2019/09/04 全球购物
考生诚信考试承诺书(2016版)
2016/03/25 职场文书
MySQL 视图(View)原理解析
2021/05/19 MySQL
Python基础学习之奇异的GUI对话框
2021/05/27 Python
Redis Cluster 集群搭建你会吗
2021/08/04 Redis
MySQL外键约束(FOREIGN KEY)案例讲解
2021/08/23 MySQL