JQuery Sparkline 说明文档
来自：http://wenku.baidu.com/link?url=G2JoOrHKrwinFAY03-QpigyvZ2Jg_fZ0JKRtEcnX7jCPyeb4F9cBSC6gT1xKt2XAyHdhPd-lKFuhImeOFdCsjvgzSyWn_oZALo6zgwSsKpm
JQuery. Sparkline线状图插件
图形的类型,共有'line' (default), 'bar', 'tristate', 'discrete', 'bullet', 'pie' , 'box'
使用Sparklines你需要四件事情：
1、jQuery JavaScript库使用至少1.2或更高版本
2、在页面中引用jquery.sparkline-2.1.2.min.js插件.
3、在页面上内嵌一个标签来显示sparkline.
4、实际上调用sparkline()函数来显示sparkline。
下面我做一个简单的小例子
首先在你的页面头部添加JS引用
<script type="text/javascript" src="jquery-1.4.4.js">script>
<script type="text/javascript" src="jquery.sparkline.js">script>
添加一个SPAN
Inline Sparkline: <span class="inlinesparkline">1,4,4,7,5,9,10</span>
JS代码
$(function() {
/** This code runs when everything has been loaded on the page */
/* Inline sparklines take their values from the contents of the tag */
$('.inlinesparkline').sparkline();
});
控件通用属性
type - line (default), bar, tristate, discrete, bullet, pie or box;
width -图表的宽度- '默认为'auto -可以是任何有效的CSS宽度- 1.5em，20像素等，对bar与tristate无效
height -图表的高度的-默认为'auto'
lineColor -图表描线颜色
fillColor -填充颜色，设置为false，以禁用填充。
chartRangeMin -指定要使用的最小值范围的Y值的图表——默认提供的最小值
chartRangeMax -指定要使用的最大值的Y值的范围图,默认提供的最大价值
composite -是否使用组合,如果为true,则不重绘图形
enableTagOptions -如果为true选项可以被指定为属性，每个标签上sparkline将进行改造，以及传递给sparkline（）函数。 另见tagOptionPrefix
tagOptionPrefix -每个选项的字符串作为一个属性传递给一个标记。默认为“spark”
tagValuesAttribute –根据属性名称的标签获取“value”
line线图特殊属性
| defaultPixelsPerValue |
每一个值所占的宽度，默认为3px |
| spotColor |
数据点的颜色,false表示不显示 |
| minSpotColor |
最小数据点的颜色,false表示不显示 |
| maxSpotColor |
最大数据点的颜色,false表示不显示 |
| spotRadius |
标志点的半径 |
| valueSpots |
{':4': 'green', '5:': 'red'},//表示低于4的用绿色表示，大于5的用红色表示 |
| highlightSpotColor |
最高数据点的颜色 |
| highlightLineColor |
最高数据线的颜色 |
| lineWidth |
线的宽度 |
| normalRangeMin, normalRangeMax |
指定阈值之间画一条表示“正常”或预期的值的范围。 指定阈值之间画一条表示“正常”或预期的值的范围。 |
| drawNormalOnTop |
默认情况下正常范围画背后的填充区域图。将此选项设置为true使其在填充区域的顶部 |
| chartRangeClip |
chartRangeMin和chartRangeMax之间——默认情况下chartRangeMin / Max只是确保图至少跨越的值的范围,但并不限制它 |
| chartRangeMinX |
指定使用的最小值的X值图 |
| chartRangeMaxX |
指定使用的最大值的X值图 |
Bar Charts柱状图特殊属性
| barColor |
柱体颜色 |
|
| negBarColor |
负柱体的颜色 |
|
| zeroColor |
柱体等于0的颜色 |
|
| nullColor |
为空的颜色 |
|
| barWidth |
柱体的宽度 |
|
| barSpacing |
柱体之间的间隔 |
|
| zeroAxis |
如果为true，把0轴线居中 |
|
| colorMap |
映射到特定值所选的颜色。例如如果你想要的值2出现黄色,使用colorMap:{“2”:“# ff0”}。 |
|
| stackedBarColor |
堆柱体的颜色 |
|
Tristate Charts特殊属性
| posBarColor |
正柱体的颜色 |
| negBarColor |
负柱体的颜色 |
| zeroBarColor |
为0时柱体的颜色 |
| barWidth |
柱体的宽度 |
| barSpacing |
柱体之间的间隔 |
| colorMap |
映射到特定值所选的颜色。例如如果你想要的值2出现黄色,使用colorMap:{“2”:“# ff0”}。 |
Discrete Charts特殊属性
| lineHeight |
每一行的像素高度,默认为30%的图的高度 |
| thresholdValue |
低于此值的将使用thresholdColor进行绘制 |
| thresholdColor |
颜色使用结合thresholdValue |
Bullet Graphs子弹图特殊属性
| targetColor |
垂直线的颜色 |
| targetWidth |
垂直线的宽度 |
| performanceColor |
中间横条的颜色 |
| rangeColors |
背景颜色变化范围 |
Pie Charts饼图特殊属性
| sliceColors |
饼图分区的颜色 |
| offset |
在度来抵消第一片- -90或+ 90 |
| borderWidth |
边框的宽度，默认没有边框 |
| borderColor |
边框的颜色，默认为“#000” |
这些小饼图只能用2或3个值
Sparkline用法
基本用法：
$(selector).sparkline(values, options);
values可以是一系列数字或从“html”标签中读取的值
<span class="sparklines">1,2,3,4,5,4,3,2,1</span>
<span id="ticker"">Loading..</span>
<script type="text/javascript">
$('.sparklines').sparkline('html');
$('#ticker').sparkline([1,2,3,4,5,4,3,2,1]);
</script>
Options选项是一个对象,它指定sparkline画的类型,颜色,等等。
$('#barchart').sparkline(myvalues, { type:'bar', barColor:'green' });
如果有必要,options可以作为属性传递在每个标签选项。
<span class="sparklines" sparkType="bar" sparkBarColor="green"><!-- 1,2,3,4,3,2,1 --></span>
<span class="sparklines" sparkType="bar" sparkBarColor="red"><!-- 1,2,3,4,3,2,1 --></span>
<script type="text/javascript">
$('.sparklines').sparkline('html', { enableTagOptions: true });
</script>
每个选项必须以“spark”为前缀。
你也可以覆盖默认的选项将值分配给所有后续微线图
$.fn.sparkline.defaults
例如:
$.fn.sparkline.defaults.common.lineColor = 'red';
或者
$.fn.sparkline.defaults.common = {
…
};
可以将commont替换为line,bar,tristate,discrete,bullet,pie等
$.extend()方法
JQuery的extend扩展方法：
Jquery的扩展方法extend是我们在写插件的过程中常用的方法，该方法有一些重载原型，
一、Jquery的扩展方法原型是:
extend(dest,src1,src2,src3...);
它的含义是将src1,src2,src3...合并到dest中,返回值为合并后的dest,由此可以看出该方法合并后，是修改了dest的结构的。如果想要得到合并的结果却又不想修改dest的结构，可以如下使用：
var newSrc=$.extend({},src1,src2,src3...)//也就是将"{}"作为dest参数。
这样就可以将src1,src2,src3...进行合并，然后将合并结果返回给newSrc了。如下例：
var result=$.extend({},{name:"Tom",age:21},{name:"Jerry",sex:"Boy"})
那么合并后的结果：
result={name:"Jerry",age:21,sex:"Boy"}
也就是说后面的参数如果和前面的参数存在相同的名称，那么后面的会覆盖前面的参数值。
二、省略dest参数
上述的extend方法原型中的dest参数是可以省略的，如果省略了，则该方法就只能有一个src参数，而且是将该src合并到调用extend方法的对象中去，如：
1、$.extend(src)
该方法就是将src合并到jquery的全局对象中去，如：
$.extend({
hello:function(){alert('hello');}
});
就是将hello方法合并到jquery的全局对象中。
2、$.fn.extend(src)
该方法将src合并到jquery的实例对象中去，如:
$.fn.extend({
hello:function(){alert('hello');}
});
就是将hello方法合并到jquery的实例对象中。
下面例举几个常用的扩展实例：
$.extend({net:{}});
这是在jquery全局对象中扩展一个net命名空间。
$.extend($.net,{
hello:function(){alert('hello');}
})
这是将hello方法扩展到之前扩展的Jquery的net命名空间中去。
三、Jquery的extend方法还有一个重载原型：
extend(boolean,dest,src1,src2,src3...)
第一个参数boolean代表是否进行深度拷贝，其余参数和前面介绍的一致，什么叫深层拷贝，我们看一个例子：
var result=$.extend( true, {},
{ name: "John", location: {city: "Boston",county:"USA"} },
{ last: "Resig", location: {state: "MA",county:"China"} } );
我们可以看出src1中嵌套子对象location:{city:"Boston"},src2中也嵌套子对象location:{state:"MA"},第一个深度拷贝参数为true，那么合并后的结果就是：
result={name:"John",last:"Resig",
location:{city:"Boston",state:"MA",county:"China"}}
也就是说它会将src中的嵌套子对象也进行合并，而如果第一个参数boolean为false，我们看看合并的结果是什么，如下：
var result=$.extend( false, {},
{ name: "John", location:{city: "Boston",county:"USA"} },
{ last: "Resig", location: {state: "MA",county:"China"} }
);
那么合并后的结果就是:
result={name:"John",last:"Resig",location:{state:"MA",county:"China"}}
以上就是$.extend()在项目中经常会使用到的一些细节。
setInterval()与setTimeOut()方法的区别
1,HTML DOM setInterval() 方法
定义和用法
setInterval() 方法可按照指定的周期（以毫秒计）来调用函数或计算表达式。
setInterval() 方法会不停地调用函数，直到 clearInterval() 被调用或窗口被关闭。由 setInterval() 返回的 ID 值可用作 clearInterval() 方法的参数。
语法
setInterval(code,millisec["lang"])
参数 描述
code 必需。要调用的函数或要执行的代码串。
millisec 必须。周期性执行或调用 code 之间的时间间隔，以毫秒计。
返回值 ：一个可以传递给 Window.clearInterval() 从而取消对 code 的周期性执行的值
2,HTML DOM clearInterval()方法
定义和用法
clearInterval() 方法可取消由 setInterval() 设置的 timeout。
clearInterval() 方法的参数必须是由 setInterval() 返回的 ID 值。
语法
clearInterval(id_of_setinterval)
参数 描述
id_of_setinterval 由 setInterval() 返回的 ID 值。
如何停止：
下面这个例子将每隔 50 毫秒调用 clock() 函数。您也可以使用一个按钮来停止这个 clock：
<html>
<body>
<form>
<input type="text" id="clock" size="35" />
<button onclick="int=window.clearInterval(int)">
Stop interval</button>
</form>
<script language=javascript>
var int=self.setInterval("clock()",50)
function clock()
{
var t=new Date()
document.getElementById("clock").value=t
}
</script>
</body>
</html>
1,HTML DOM setTimeout() 方法
定义和用法
setTimeout() 方法用于在指定的毫秒数后调用函数或计算表达式。
语法
setTimeout(code,millisec)
参数 描述
code 必需。要调用的函数后要执行的 JavaScript 代码串。
millisec 必需。在执行代码前需等待的毫秒数。
提示和注释
提示：setTimeout() 只执行 code 一次。如果要多次调用，请使用 setInterval() 或者让 code 自身再次调用 setTimeout()。
实例,这个例子，在你点击按钮 5 秒钟后会弹出一个提示框：
<html>
<head>
</head>
<body>
<form>
<input type="button" value="Display timed alertbox!"
onClick="timedMsg()">
</form>
<p>Click on the button above. An alert box will be
displayed after 5 seconds.</p>
<script type="text/javascript">
function timedMsg()
{
var t=setTimeout("alert('5 seconds!')",5000)
}
</script>
</body>
</html>
2,HTML DOM clearTimeout() 方法
定义和用法clearTimeout() 方法可取消由 setTimeout() 方法设置的 timeout。语法clearTimeout(id_of_settimeout)
参数 描述
id_of_setinterval 由 setTimeout() 返回的 ID 值。该值标识要取消的延迟执行代码块。
实例下面的例子每秒调用一次 timedCount() 函数。您也可以使用一个按钮来终止这个定时消息：
<html>
<head>
</head>
<body>
<form>
<input type="button" value="Start count!" onClick="timedCount()">
<input type="text" id="txt">
<input type="button" value="Stop count!" onClick="stopCount()">
</form>
<script type="text/javascript">
var c=0
var t
function timedCount()
{
document.getElementById('txt').value=c
c=c+1
t=setTimeout("timedCount()",1000)
}
function stopCount()
{
clearTimeout(t)
}
</script>
</body>
</html>