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>