jQMeter是一款简单实用的轻量级进度条jQuery插件,它可以显示为水平或垂直进度条,进度条加载时带有动画特效,你只需要简单的传入一些参数到jQMeter对象的构造函数中就可以完成你想要的进度条效果。
该进度条插件的构造函数中允许你定义进度条的宽度、高度、背景色、进度条颜色等等参数,通过这些参数你可以构造自己的进度条样式。
使用方法
使用这个进度条插件必须先引入jQuery和jqmeter.min.js文件。
HTML结构
该进度条插件的HTML结构使用一个空的
初始化插件
在页面加载完毕之后,可以通过下面的方法来调用该进度条插件。
$(document).ready(function(){
$('#jqmeter-container').jQMeter();
});
注意:该进度条插件有两个必填的参数:goal和raised。此外还有一些可用的参数,其中一些参数也可以使用css来实现,如颜色参数。
$('#jqmeter-container').jQMeter({
goal:'$1,000',
raised:'$200',
orientation:'vertical',
width:'50px',
height:'200px'
});
配置参数
参数
类型
默认值
描述
goal
string
无默认值,必填参数
进度条的总长度。可以设置为字符串,如"$9000",或整数,如:"9000"
raised
string
无默认值,必填参数
进度条的当前进度。可以设置为字符串,如"$5000",或整数,如:"5000"
width
string
100%-水平宽度。(在水平进度条中必须设置)
设置进度条的水平宽度。可以设置为百分比或像素值
height
string
50px。(在垂直进度条中必须设置)
设置进度条的垂直高度。可以设置为百分比或像素值
bgColor
string
#444
进度条的背景颜色。支持hex、rgba和颜色关键字。
barColor
string
#bfd255
进度条的颜色。支持hex、rgba和颜色关键字。
orientation
string
horizontal
进度条的方向,可设置为: 'horizontal' 或 'vertical'。如果设置为垂直进度条,该参数必须设置。
displayTotal
boolean
true
是否显示进度条完成的百分比数。
animationSpeed
integer
2000
进度条动画时间,单位毫秒
counterSpeed
integer
2000
进度条计数的时间,单位毫秒