【jQuery UI 1.8 The User Interface Library for jQuery】.学习笔记.9.Progressbar控件

Progressbar控件用来显示任意进程的完成百分比。

• 默认安装启用
• 配置选项
• 控件暴露的事件API
• progressbar暴露的独一无二的方法
• 一些现实生活的例子

当前版本中，我们或系统必须明确进度的总量。

由外部<div>容器和 内部<div>容器构成。内部的<div>用来高亮当前进度。

1 安装启用默认的 progressbar

1 <div id="myProgressbar"> 2 </div> 3 <script src="development-bundle/jquery-1.4.4.js"></script> 4 <script src="development-bundle/ui/jquery.ui.core.js"></script> 5 <script src="development-bundle/ui/jquery.ui.widget.js"></script> 6 <script src="development-bundle/ui/jquery.ui.progressbar.js"></script> 7 <script> 8 $(function(){ 9 $("#myProgressbar").progressbar(); 10 }); 11 </script>

在例子中，我们使用了<div>元素。但是任何 块级 的元素  block-level elements ，比如 <a> ，也能使用。控件会在初始化时，给这个指定的元素添加一个代表progressbar的值得嵌入<div>元素。

这个控件，会像其他控件一样，填满它的外层容器。组件会自动给外层容器和内层<div>添加一系列的属性和classnames。

ARIA-compliant 这个附加的属性也会被添加到控件。使得控件完全支持浏览者使用辅助技术访问。

2 progressbar的配置选项

Option	Default Value	Used to…
disabled	false	禁用控件
Value	0	用百分率的方式设置控件的值

2.1 设置 progressbar 的值

1 var progressbarOption={ 2 value:50 3 }

value选项通过一个整数，以百分比的方式设置内层<div>的宽度。

3 progerssbar的event API

Event	Fired when…
create	当控件初始化后
change	控件值变化
complete	控件的值达到100%

1 <div id="myProgressbar"> 2 </div> 3 <button id="increase">Increase by 10%</button> 4 5 $(function(){ 6 var progress = $("#myProgressbar"); 7 var progressbarOpts={ 8 change:function(){ 9 var val=$(this).progressbar("option","value"); 10 if(!$("#value").length){ 11 console.log("no"+val); 12 $("<span id='value' />").text(val+"%").css({float:"right",marginTop:-28,marginRight:10}).appendTo(progress); 13 } 14 else{ 15 $("#value").text(val+"%"); 16 console.log("yes"+val); 17 } 18 } 19 }; 20 progress.progressbar(progressbarOpts); 21 $("#increase").click(function(){ 22 var currentVal=progress.progressbar("option","value"), 23 newVal=currentVal+10; 24 progress.progressbar("option","value",newVal); 25 }); 26 });

我们首先为存储progressbar的选择器，然后为 change event 定义一个 event handler 。在这个回调函数中，我们首先获得progressbar的最后更新的值。字 event handler中，我们可以使用 $(this) 来选择 progressbar。

提供的值要小于等于100，我们检查这个页面上是否已经有一个元素包含 id=value 。如果这里没有，我们就新建一个 <span> 元素，并且设置它的text和当前的位置。我们同样给他一个id 和 Position ，所以它显示在progressbar的里面。如果元素已经存在，我们只需要将他的text设为新值。

当点击button时，首先使用 option 方法的 getter 模式，得到 progressbar 的当前值。

也可以使用 jQuery 的 bind() 方法，在事件的名字前加上控件的名字作为前缀，例如 progressabarchange。

4 Progressbar 的方法

除了所有库组件都有的 destroy disable,enalbe,option方法，progressbar还有一个 value 方法，它可以以捷径的方式使用 option 方法，设置progressbar的值。

1 $("#increase").click(function(){ 2 var currentVal=progress.progressbar("option","value"), 3 newVal=currentVal+10; 4 progress.progressbar("value",newVal); 5 });

5 用户发起进展 User initiated progress

在这个最基础的等级，在用户交互中，我们能手动更新progressbar。我们可以指定一个向导形式的 表单，它拥有几个步骤来完成。在每个步骤，我们可以手动增加progressbar，让用户知道他们完成了多少。

 

1 <style> 2 h1, h2 { font-family:Georgia; font-size:140%; margin-top:0;} 3 h2 { margin:20px 0 10px; font-size:100%; text-align:left;} 4 p { 5 margin:0; font-size:75%; position:absolute; left:30px; 6 top:60px; font-weight:bold; 7 } 8 #amount { 9 position:absolute; right:30px; top:60px; font-size:80%; 10 font-weight:bold; 11 } 12 #thanks { text-align:center;} 13 #thanks p { 14 margin-top:48px; font-size:160%; position:relative; left:0; 15 top:0; 16 } 17 form { height:265px; position:relative;} 18 .form-container { 19 width:400px; margin:0 auto; position:relative; 20 font-family:Verdana; font-size:80%; padding:20px; 21 background-color:#e0e3e2; border:1px solid #abadac; 22 } 23 .form-panel { 24 width:400px; height:241px; position:absolute; top:0; left:0;} 25 fieldset { 26 width:397px; height:170px; margin:0 auto; padding:22px 0 0; 27 border:1px solid #abadac; background-color:#ffffff; 28 } 29 label { 30 width:146px; display:block; float:left; text-align:right; 31 padding-top:2px; margin-right:10px; 32 } 33 input, textarea { 34 float:left; width:200px; margin-bottom:13px; 35 } 36 button { float:right;} 37 </style> 38 </script> 39 40 <div class="form-container ui-helper-clearfix ui-corner-all"> 41 <h1>Registration Form</h1> 42 <p>Progress:</p> 43 <div id="progress"></div> 44 <label id="amount">0%</label> 45 <form action="serverScript.php"> 46 47 <div class="form-panel"> 48 <h2>Personal Details</h2> 49 <fieldset class="ui-corner-all"> 50 <label>Name:</label> 51 <input type="text"> 52 <label>D.O.B:</label> 53 <input type="text"> 54 <label>Chose password:</label> 55 <input type="password"> 56 <label>Confirm password:</label> 57 <input type="password"> 58 </fieldset> 59 </div> 60 61 <div class="form-panel ui-helper-hidden"> 62 <h2>Contact Details</h2> 63 <fieldset class="ui-corner-all"> 64 <label>Email:</label> 65 <input type="text"> 66 <label>Telephone:</label> 67 <input type="text"> 68 <label>Address:</label> 69 <textarea rows="3" cols="25"></textarea> 70 </fieldset> 71 </div> 72 73 <div class="form-panel ui-helper-hidden"> 74 <h2>Registration Complete</h2> 75 <fieldset class="ui-corner-all"> 76 <p>Thanks for registering!</p> 77 </fieldset> 78 </div> 79 80 81 </form> 82 <button id="next">Next</button> 83 <button id="back" disable="disabled">Back</button> 84 </div> 85 86 87 $(function(){ 88 var prog=$("#progress"), 89 progressOpts={ 90 change:function(){ 91 prog.next().text(prog.progressbar("value")+"%"); 92 } 93 }; 94 prog.progressbar(progressOpts); 95 $("#next,#back").click(function(){ 96 $("button").attr("disabled",true); 97 if(this.id=="next"){ 98 console.log("next button"+prog.progressbar("option","value")); 99 prog.progressbar("option","value",prog.progressbar("option","value")+50); 100 $("form").find("div:visible").fadeOut().next().fadeIn(function(){ 101 $("#back").attr("disabled",false); 102 if(!$("form").find("div:last").is(":visible")){ 103 $("#next").attr("disabled",false); 104 } 105 }); 106 }else{ 107 console.log("prev button"+prog.progressbar("option","value")); 108 prog.progressbar("option","value",prog.progressbar("option","value")-50); 109 $("form").find("div:visible").not(".buttons").fadeOut().prev().fadeIn(function(){ 110 $("#next").attr("disabled",false); 111 if(!$("form").find("div:first").is(":visible")){ 112 $("#back").attr("disabled",false); 113 } 114 }); 115 } 116 }); 117 });

6 使用 progressbar 的富 uploads

HTML5 文件 API，异步 upload 文件，在文件被上传时，使用 onprogress 事件更新 progressbar 。尽管 onprogress 事件被定义在 官方 W3C 规格说明书中，但目前仅被Firefox 和 webkit 实现。 getAsBinary() 方法只有 Firefox 3.5+有， webkit 浏览器没。