JQuery Sparkline 说明文档

景嘉实
2023-12-01

来自: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 οnclick="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>                                                              

 

 类似资料: