jqPlot 图表中文API使用文档及源码和在线示例


Posted in Javascript onFebruary 07, 2012

简介

jqplot是一款非常不错的基于jquery的图表插件,这篇文章主要帮助大家整理了jqplot的中文使用说明和在线示例及源码下载。jqplot插件在支持HTML5的浏览器上将会在canvas上呈现图表。

引入脚本文件

jqplot需要1.4.3以上的jquery版本支持,刚才说过了,jqplot在支持HTML5 Canvas的浏览器上将以canvas呈现,否则,如果你在IE9以下版本的浏览器上则要引入excanvas.js文件,当然,jqplot的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" />

添加一个plot容器

我们可以在页面上为jqplot添加一个容器,比如div,但要注意的是,要为这个div容器指定宽度好高度,如下代码:

<div id="chartdiv" style="height:400px;width:300px; "></div>

开始创建plot图表

接下来我们在上面创建好的容器中通过调用$.jqplot实现图表的生成和渲染,比如如果用下面的数据来初始化jqplot图表:

$.jqplot('chartdiv', [[[1, 2],[3,5.12],[5,13.1],[7,33.6],[9,85.9],[11,219.9]]]);

最终显示效果如下图所示:
jqPlot 图表中文API使用文档及源码和在线示例
jqplot属性选项
我们在调用$.jqplot时可以传入一些参数options来自定义jqplot,部分参数options如下:

seriesColors: [ "#4bb2c5", "#c5b47f", "#EAA228", "#579575", "#839557", "#958c12", 
"#953579", "#4b5de4", "#d8b83f", "#ff5800", "#0085cc"], // 默认显示的分类颜色,如果分类的数量超过这里的颜色数量, 
// 则从该队列中第一个位置开始重新取值赋给相应的分类 
stackSeries: false, // 如果置为true并且有多个分类(如果是折线图,就必须多于一条折线), 那么每个分类(折线) 
//在纵轴上的值为其前所有分类纵轴值总和与其纵,轴值相加值 
title: '', //设置当前图的标题 
title: { 
text: '', //设置当前图的标题 
show: true,//设置当前图的标题是否显示 
}, 
axesDefaults: { 
show: false, 是否自动显示坐标轴。 
min: null, 横(纵)轴最小刻度值 
max: null, 横(纵)轴最大刻度值 
pad: 1.2, 横(纵)轴度值增涨因子 
ticks: [], //设置横(纵)坐标的刻度上的值,可为该ticks数组中的值 
numberTicks: undefined,//一个相除因子,用于设置横(纵)坐标刻度间隔,横(纵)坐标刻度间隔值=横(纵)坐标区间长度/(numberTicks-1) 
renderer: $.jqplot.LinearAxisRenderer, // 设置横(纵)轴上数据加载的渲染器 
rendererOptions: {}, // 设置renderer的Option配置对象,线状图不需要设置 
tickOptions: { 
mark: 'outside', // 设置刻度在坐标轴上的显示方式:分为:坐标轴外显示,内显示,和穿过显示;其值分别为 'outside', 'inside' or '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: { 
// same options as axesDefaults 
}, 
yaxis: { 
// same options as axesDefaults 
}, 
x2axis: { 
// same options as axesDefaults 
}, 
y2axis: { 
// same options as axesDefaults 
} 
}, 
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, // Opacity of the shadow. 
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;" mce_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相同属性设置 
} 
} 
}

这里给一个使用自定义参数的例子:
$.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'}] 
});

显示效果如下图所示:

jqPlot 图表中文API使用文档及源码和在线示例

源码下载 https://3water.com/jiaoben/35457.html
其官方网站:http://www.jqplot.com/。
Javascript 相关文章推荐
javascript 通用简单的table选项卡实现
May 07 Javascript
JavaScript 原型链学习总结
Oct 29 Javascript
IE6浏览器中window.location.href无效的解决方法
Nov 20 Javascript
JavaScript使用addEventListener添加事件监听用法实例
Jun 01 Javascript
js实现统计字符串中特定字符出现个数的方法
Aug 02 Javascript
jQuery实现立体式数字滚动条增加效果
Dec 21 Javascript
JS实现线性表的链式表示方法示例【经典数据结构】
Apr 11 Javascript
解决vue-router中的query动态传参问题
Mar 20 Javascript
详解Vue 如何监听Array的变化
Jun 06 Javascript
VUE渲染后端返回含有script标签的html字符串示例
Oct 28 Javascript
微信小程序按顺序同步执行的两种方式
Dec 20 Javascript
React实现评论的添加和删除
Oct 20 Javascript
jquery中的mouseleave和mouseout的区别 模仿下拉框效果
Feb 07 #Javascript
jquery 操作日期、星期、元素的追加的实现代码
Feb 07 #Javascript
jQuery插件原来如此简单 jQuery插件的机制及实战
Feb 07 #Javascript
jQuery之end()和pushStack()使用介绍
Feb 07 #Javascript
详解强大的jQuery选择器之基本选择器、层次选择器
Feb 07 #Javascript
JavaScript 5 新增 Array 方法实现介绍
Feb 06 #Javascript
ASP.NET jQuery 实例18 通过使用jQuery validation插件校验DropDownList
Feb 03 #Javascript
You might like
探讨php define()函数及defined()函数使用详解
2013/06/09 PHP
php查看请求头信息获取远程图片大小的方法分享
2013/12/25 PHP
php随机显示指定文件夹下图片的方法
2015/07/13 PHP
php设计模式之委托模式
2016/02/13 PHP
php数组遍历类与用法示例
2019/05/24 PHP
PHP copy函数使用案例代码解析
2020/09/01 PHP
Alliance vs Liquid BO3 第一场2.13
2021/03/10 DOTA
jquery的extend和fn.extend的使用说明
2011/01/09 Javascript
Javascript访问器属性实例分析
2014/12/30 Javascript
Node.js抓取中文网页乱码问题和解决方法
2015/02/10 Javascript
javascript框架设计之浏览器的嗅探和特征侦测
2015/06/23 Javascript
使用JavaScript脚本无法直接改变Asp.net中Checkbox控件的Enable属性的解决方法
2015/09/16 Javascript
浅谈JavaScript的计时器对象
2016/12/26 Javascript
Webpack path与publicPath的区别详解
2018/05/03 Javascript
vue-cli中使用高德地图的方法示例
2019/03/28 Javascript
vue中实现点击按钮滚动到页面对应位置的方法(使用c3平滑属性实现)
2019/12/29 Javascript
JS删除数组指定值常用方法详解
2020/06/04 Javascript
Python实现将不规范的英文名字首字母大写
2016/11/15 Python
python使用生成器实现可迭代对象
2018/03/20 Python
python解析xml简单示例
2019/06/21 Python
Python如何基于selenium实现自动登录博客园
2019/12/16 Python
python如何实现word批量转HTML
2020/09/30 Python
html5本地存储_动力节点Java学院整理
2017/07/12 HTML / CSS
怎样实现H5+CSS3手指滑动切换图片的示例代码
2019/05/05 HTML / CSS
全球领先美式家具品牌:Ashley爱室丽家居
2017/08/07 全球购物
阿根廷旅游网站:almundo阿根廷
2018/02/12 全球购物
Yummie官方网站:塑身衣和衣柜必需品
2019/10/29 全球购物
意大利网上药房:Farmacia 33
2020/01/27 全球购物
XML文档定义有几种形式?它们之间有何本质区别?解析XML文档有哪几种方式?
2016/01/12 面试题
毕业生找工作推荐信
2013/11/21 职场文书
小学数学国培感言
2014/03/10 职场文书
民主评议党员自我评议范文2014
2014/09/26 职场文书
医者仁心观后感
2015/06/17 职场文书
详解Go语言Slice作为函数参数的使用
2021/07/02 Golang
新手初学Java网络编程
2021/07/07 Java/Android
MySQL选择合适的备份策略和备份工具
2022/06/01 MySQL