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>