不得不爱开源 Wijmo jQuery 插件集(7)-【进度条】(附页面展示和源码)
园子中的朋友大家好。在上一篇文章中我们,给大家介绍了 Wijmo Popup 插件的特性及使用方法。感谢园子中朋友的支持,朋友们的支持给我们写这一系列文章提供了很大的动力。在这篇文章中我们将介绍进度条 的特性及使用方法。
有些朋友第一次看到本系列文章,所以给出本系列文章的链接:
- 不得不爱开源 Wijmo jQuery 插件集(1)-【开篇】(附演示和源码)
- 不得不爱开源 Wijmo jQuery 插件集(2)-【准备工作】(附30种Theme演示和源码)
- 不得不爱开源 Wijmo jQuery 插件集(3)-【Menu】(附页面展示和源码)
- 不得不爱开源 Wijmo jQuery 插件集(4)-【手风琴效果】(附页面展示和源码)
- 不得不爱开源 Wijmo jQuery 插件集(5)-【对话框】(附页面展示和源码)
- 不得不爱开源 Wijmo jQuery 插件集(6)-【Popup】(附页面展示和源码)
首先让我们看看 Wijmo 进度条 给我们带来了哪些惊喜?
用ComponentOne为ASP.NET Wijmo出品的 ProgressBar™控件,可以让最终用户了解一个操作的进度。你可以轻松地用动画、样式、标签,等等来自定义指针的外观。
建立你的第一个 Wijmo jQuery Wijpopup (感兴趣的朋友可以下载【资源分享中的 Demo】):
HTML <div id= "progressbar" style= "50px;height:300px" ></div> jQuery 脚本 <script id= "scriptInit" type= "text/javascript" > $(document).ready(function () { $( "#progressbar" ).wijprogressbar({ value: 75, fillDirection: "north" }); }); </script> |
效果预览:
特性
水平或垂直方向
在默认情况下,进度条一般是水平的,但是你可以通过将fillDirection选项设置为向北或向南,来将它设置为垂直的。
动画
它可以制作进度条填充效果的动画效果,可以从超过三十种款式中进行选择。你还可以为每一个动画设置其速度和频率。
自定义标签
它可以自定义标签的位置,使它出现在控件的右侧、底部、左侧、顶部,或者控件的中心。当进度条正在填充时,你还可以设置标签使它像一个选取框一样运行,并将标签格式化。
CSS支持
你可以使用这一种级联样式表(CSS)的样式来定义自定义皮肤。有了CSS支持,你可以使该进度条与你的组织标准相匹配。
主题
只需点击一下智能标签,就可以通过从六个溢价主题(北极,午夜时分,雅集,火箭,钴和英镑)中选择一个来改变进度条控件的外观。另外,还可以使用jQuery UI中的ThemeRoller来创建一个自定义的主题!
最后,和大家分享一些 Wijmo 资源:
1.源码下载(包含以上特性):Wijmo-ProcessBar.zip
2.更多信息请参考:Wijmo 中文网站:http://www.gcpowertools.com.cn/products/c1_asp_overview.htm
3.开源Wijmo jQuery 讨论社区: http://gcdn.grapecity.com/index.aspx
wijprogressbar API 介绍:(点击隐藏 API)
Options
下列为 wijprogressbar 选项:
animationDelay
- 以毫秒为单位获取或设置 wijprogressbar 动画效果的延迟时间。默认值为 "0".
- Type: Number
- Default: 0
- Code example:
$(
'.selector’).wijprogressbar('
option
', '
animationDelay', 300);
animationOptions
- jQuery 动画选项。
- Type: Options
- Default: {disabled: false, easing: null, duration: 500}
- Code example:
$(
'.selector’).wijprogressbar('
option
','
animationOptions
',{animated:'
progress',duration:600);
disabled
- 禁止或允许 wijprogressbar。在初始化 wijprogressbar 时设置。
- Type: Boolean
- Default: false
- Code Example:
$(
"selector"
).wijprogressbar({disabled:
true
});
fillDirection
- 设置 wijprogressbar 的填充方向。可选项为"east","west","south" or "north".
- Type: String
- Default: 'east'
- Code example:
1
$(
'.selector’).wijprogressbar('
option
', '
fillDirection
', '
east')
indicatorImage
- 指示器的图片路径。
- Type: String
- Default:
- Code example:
$(
'.selector’).wijprogressbar('
option
','
indicatorImage
','
images/abc.png')
indicatorIncrement
- 指示器的增加单位。
- Type: Number
- Default: 1
- Code example:
1
$(
'.selector’).wijprogressbar('
option
','
indicatorIncrement',10);
labelAlign
- wijprogressbar 的 lable(即进度显示数字)的对齐方式。可选项有"west","east","center","north","south", or "running".
- Type: String
- Default: 'center'
- Code example:
$(
'.selector’).wijprogressbar('
option
', '
labelAlign
', '
center')
labelFormatString
- wijprogressbar label 格式化字符串。可用格式列表:
- {0} or {ProgressValue} 整形
- {1} or {PercentProgress} 百分比
- {2} or {RemainingProgress}显示wijprogressbar 剩余进度
- {3} or {PercentageRemaining} 显示wijprogressbar 剩余进度百分比
- {4} or {Min} wijprogressbar 最小值
- {5} or {Max} wijprogressbar 最大值
- Type: String
- Default: '{1}%'
- Code example:
$(
'.selector’).wijprogressbar('
option
', '
labelFormatString
','
{0}%');
maxValue
- wijprogressbar 的最大值(数值型)
- Type: Number
- Default: 100
- Code example:
$(
'.selector’).wijprogressbar('
option
', '
value', 60);
minValue
- wijprogressbar 的最小值(数值型)
- Type: Number
- Default: 0
- Code example:
$(
'.selector’). wijprogressbar('
option
', '
minValue', 0)
toolTipFormatString
- 设置 wijprogressbar 的提示信息,设置格式请参考 labelFormatString.。
- Type: String
- Default: '{1}%'
- Code example:
$(
'.selector’).wijprogressbar('
option
', '
toolTipFormatString
','
{1}%')
value
- wijprogressbar 当前值。
- Type: Number
- Default: 0
- Code Example:
$(
'.selector’).wijprogressbar('
option
','
value',300);
Events
下列为 wijprogressbar 事件:
beforeProgressChanging(event,params)
- 在 wijprogressbar 运行之前触发。参数为 object: {oldValue:xxx,newValue:xxx}。返回值为 "false"阻止进度条运行。
- Type: Function
- Default: null
- Parameters:
- data:
- data.oldValue: This is the old value of the progressbar.
- data.newValue: This is the new value of the progressbar.
- data:
- Code example:
-
$(
"#selector"
).wijprogressbar({beforeProgressChanging:
function
(e, data){
// 添加操作
// return false 取消事件
}})
$(
"#selector"
).bind(
"wijprogressbarbeforeprogresschanging"
,
function
(e,data){})
progressChanged(event,params)
- 在 wijprogressbar 运行结束时触发。参数为 object: {oldValue:xxx,newValue:xxx}。
- Type: Function
- Default: null
- Parameters:
- e: This is the jquery event object.
- data
- data.oldValue: 进度条运行之前值
- data.newValue: 进度条运行之后值
- Code example:
-
$(
"#selector"
).wijpaogressbar({progressChanged:
function
(e, data){
// 添加操作
}})
$(
"#selector"
).bind(
"wijprogressbarprogresschanged"
,
function
(e,data){})
progressChanging(event,params)
- 在 wijprogressbar 运行时触发。参数为 object: {oldValue:xxx,newValue:xxx}。返回值为 "false"阻止进度条运行。
- Parameters:
- data:
- data.oldValue: 进度条运行之前值
- data.newValue: 进度条运行之后值
- data:
- Code example:
-
$(
"#selector"
).wijprogressbar({progressChanging:
function
(e,data){
alert(
'oldValue'
+ data.oldValue +
',newValue:'
+ data.newValue);
// return false 取消事件
}})
$(
"#selector"
).bind(
"wijprogressbarprogresschanging"
,
function
(e,data){})
Methods
下列为 wijprogressbar 方法:
destroy()
- 使 wijprogressbar 回到初始化状态。
- Code Example:
$(
" selector "
).wijprogressbar(
"destroy"
);
disable()
- 使 wijprogressbar 失效。
- Code Example:
1
$(
" selector "
).wijprogressbar(
"disable"
);
enable()
- 激活 wijprogressbar 。
- Code Example:
$(
" selector "
).wijprogressbar(
"enable "
);
option()
- 获取 wijprogressbar 选项。
- Code Example:
$(
" selector "
).wijprogressbar(
"option"
, optionName , [value]);
option()
- 一次性获取 wijprogressbar 多个选项
- Code Example:
$(
" selector "
).wijprogressbar(
"option"
, options);
value()
- 设置 wijprogressbar 当前值
- Code Example:
$(
" selector "
).wijprogressbar(
"value"
);
widget()
- 返回 .wijmo-wijprogressbarelement 对象。
- Code Example:
$(
" selector "
).wijprogressbar(
"widget"
);