asPieProgress是一款基于HTML5 SVG的jQuery圆形进度条动画特效插件。这个圆形进度条在在初始化的时候使用jQuery来添加SVG代码,然后可以在SVG上执行进度条动画效果。它还可以用于制作倒计数效果。
使用方法
使用该圆形进度条插件先要引入jQuery和jquery-asPieProgress.js以及progress.css文件。
<link rel="stylesheet" href="css/progress.css">
<script src="jquery.min.js" type="text/javascript"></script>
<script type="text/javascript" src="src/jquery-asPieProgress.js"></script>
HTML结构
该圆形进度条的基本HTML结构如下:
<div class="pieProgress" role="progressbar" data-goal="100" aria-valuemin="0" data-step="2" aria-valuemax="100">
<div class="progress__meter"><span class="progress__label"></span></div>
</div>
你可以直接在HTML中通过HTML5 data-*属性来为圆形进度条传递参数,也可以在初始化时通过js来传递参数。
初始化插件
在页面加载完毕之后可以通过下面的方法来初始化该圆形进度条。
$(".progress").asPieProgress({
namespace: 'pieProgress'
});
配置参数
下面是一些可用的配置参数。
{
namespace: 'asPieProgress',//名称空间
min: 0, //最小值
max: 100, //最大值
goal: 100, //总数
step: 1, //步长
speed: 50, // refresh speed
delay: 300, //延迟
easing: 'ease',//easing效果
label: function(n) { //显示的文字
var percentage = this.getPercentage(n);
return percentage;
},
onStart: function(){},
onStop: function(){},
onUpdate: function(){},
onReset: function(){}
}
方法
该圆形进度条插件提供了一些可用的公共方法:
$(".progress").asPieProgress("start");
$(".progress").asPieProgress("stop");
$(".progress").asPieProgress("done");
$(".progress").asPieProgress("go", 50);
$(".progress").asPieProgress("go", '50%');
$(".progress").asPieProgress("reset");
事件
asPieProgress::start
asPieProgress::stop
asPieProgress::done
asPieProgress::update
asPieProgress::reset