介绍 JQuery 强大的jWiard 向导控件
2011-10-28 11:47 随风浪迹天涯 阅读(2071) 评论(0) 编辑 收藏 举报我就不贴我现在做项目的代码,我直接把作者的示例搬过来,因为改动不大,只要做点修改,就能很好的满足我们自己的需求。
原文地址 猛点这里下载
作者官网 不过是英文的,英语好的话 可以看原文,生怕我表达错误。
不知道童鞋们在平时的开发用到用向导式开发这种方式没有?有人问 什么是向导式开发呢?其实,很简单,就是让用户完成一个步骤,然后点击下一步,完成一个步骤就点击下一步,这样 按照我师父的来说,可以很好的提升用户体验。
OK,废话不说了,先来一个最简单的例子:
例子1:
1.1当然咯,既然是JQuery 就少不了需要引用JQuery库吧。在上面就能下到相关的类库。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 <!-- jquery ui theme -->
2 <link rel="stylesheet" href="/path/to/jquery-ui.css" />
3 <!-- required CSS basics -->
4 <link rel="stylesheet" href="/path/to/jWizard.base.css" />
5
6 <!-- duh -->
7 <script type="text/javascript" src="/path/to/jquery.js"></script>
8 <!-- at least the widget factory -->
9 <script type="text/javascript" src="/path/to/jquery-ui.js"></script>
10 <!-- and the plugin itself -->
11 <script type="text/javascript" src="/path/to/jWizard.min.js"></script>
1.2 然后就开始写 HTML代码了,也很简单。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 <form id="wizard-form" class="jWizard">
2 <fieldset>
3 <legend>Beginning</legend>
4 <p>Are you sure you want to begin? Press "Next" to proceed?</p>
5 </fieldset>
6 <fieldset>
7 <legend>Middle</legend>
8 <p>Are you sure you want to?</p>
9 <p>You can still go back. Or press "Next" again to confirm.</p>
10 </fieldset>
11 <fieldset>
12 <legend>End</legend>
13 <p>Done, click "Finish" to end</p>
14 </fieldset>
15 </form>
16
17 <!-- Can also just be divs with title attributes -->
18 <div id="wizard-div" class="jWizard">
19 <div title="Beginning">
20 <p>Are you sure you want to begin? Press "Next" to proceed?</p>
21 </div>
22 <div title="Middle">
23 <p>Are you sure you want to?</p>
24 <p>You can still go back. Or press "Next" again to confirm.</p>
25 </div>
26 <div title="End">
27 <p>Done, click "Finish" to end</p>
28 </div>
29 </div>
你可以在上面的HTML代码了 进行添加相关的div,不过 可别忘记了给最外面的赋上title值哦。
1.3 js开始调用。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 $(".jWizard").jWizard({
2 menuEnable: true,
3 counter: {
4 enable: true,
5 progressbar: true
6 },
7 effects: { enable: true }
8 });
OK, 到此为止,上面的基本步骤就实现了,效果如下:
示例 2:给next添加事件
在我现在做的第一个版本里,刚开始比如有上传文件,验证文件等等操作,很二的直接在页面放了一个button,然后触发它的javascript代码。这样做可以满足基本功能的需求,可是也非常严重的损害了用户的体验。因为,现在的用户非常的懒,能少做一点事情,它是绝对不会多做的。所以,如果你放一个button,用户不想去点击,然后就点击next了,那么就得不到需要的用户,就会报错。
因此,我们可以把一些操作都集成到Next中去,那这样子就灰常灰常的方便了,而且页面也变的灰常灰常的整洁大方。
其余代码可以基本不变,现在我主要讲一下js里面的事件机制,代码如下:
1 var $w = $("#events-test");
2
3 $w.validate({ errorClass: "ui-state-error-text" });
4
5 $w
6 .jWizard({
7 buttons: {
8 cancelType: "reset", // 点击”Cancel“按钮的时候 触发的动作,比如我在项目中,是跳到第一页 重新开始。
9 finishType: "submit" // 在最后一步点击”finish“的时候,出发的动作,也就是提交。
10 },
11
12 // 点击”Cancel“按钮的时候 触发的动作,比如我在项目中,是跳到第一页 重新开始。
13 cancel: function(event, ui) {
14 $w.jWizard("firstStep");
15 },
// 点击previous的时候触发的动作。比如在我项目中,因为当把所有的邮件都发送完毕的时候,就不能让用户上一页了,所以我要把上一页的功能给进禁止掉。很简单,如下;
16 previous: function(event, ui) {
17 // if(ui.currentStepIndex==7){return false;} 就可以了。7 指的是你的div的顺序数字,从0开始,哈这个会数吧。
18 },
19 next: function(event, ui) {
20 // 这里同理哦,就是控制下一页的情况,也是上面一样。比如,在我项目中,有一个上传数据的,要是没有就不能让它上传。这种情况 你可以先设定一个bool值,然后,
21 if(fileUploadComplete){
$.get("@Url.Action("VerificationSchema", "Home")", // 这里学习MVC的童鞋们应该很熟悉 其实也就是在action home 下面的方法 VerificationSchema
function (data) { // 获取成功后返回的数据
var newData = eval(data); // 因为用的json 所以用eval 进行转换
schemaVerification=newData.HasErrors;
if(newData.HasErrors) {
var listing1 = document.getElementById("listing1");
listing1.innerHTML = "<font color='red' size='20px'>Congruations.Please go on.</font>";
}
else {
document.getElementById("ErrorNotification").innerHTML="Sorry.Your Schema wrong,please check it.";
var listing1 = document.getElementById("listing1");
listing1.innerHTML = newData.Result;
}
},"json");}
else { //这里主要是当没有选择数据的时候 进行提示
alert("Please firstly Upload the Excel File you need");
return false; }
break;
},
22 finish: function(event, ui) {
23 alert("Thank you!");
24 }
25 })
26 /** The bindings below are event handlers, they will all be executed before proceeding to the callback */
27 /** ui = {
28 type: "previous|next|first|last|manual",
29 currentStepIndex: [int],
30 nextStepIndex: [int]
31 }; */
32
33 // This event handler is specifically used for form validation
34 .bind("jwizardchangestep", function (event, ui) {
35 // "manual" is always triggered by the user, never jWizard itself
36 if (ui.type !== "manual") {
37 var $currentStep = $w.find(".jw-step:eq(" + ui.currentStepIndex + ")"),
38 $inputs = $currentStep.find("input:text");
39
40 /** I am assuming you have `jquery.validate.js` running in this callback */
41 if ($inputs.length > 0 && !$inputs.valid()) {
42 $currentStep.find("label.error").effect("highlight");
43 return false;
44 }
45 }
46 })
47
48 // This event handler is for handling custom navigation through the wizard
49 .bind("jwizardchangestep", function (event, ui) {
50 // "manual" is always triggered by the user, never jWizard itself
51 if (ui.type !== "manual") {
52 // 这里其实是比较重要的,因为这里就是选择对应div的实现方式的,你只需要把相应模块的javascript代码集成到这里就可以了。
53 switch (ui.currentStepIndex) {
54 // on the first step, the user must agree to the terms and conditions
55 case 0:
56 if ($("#agree").is(":not(:checked)")) {
57 // use this effect to give the user feedback
58 $("#agree").parent().effect("pulsate");
59 return false;
60 }
61 break;
62 // on the 3rd step, (zero-index) the username being filled means we are skipping the openid step
63 case 2:
64 if ($("#username").val() != "") {
65 // by setting this value on the event object, I am telling jWizard to override the nextStepIndex
66 event.nextStepIndex = 4;
67 // you must at least call event.preventDefault(); in order for this to work
68 return false;
69 }
70 break;
71 }
72 }
73
74 // by using nextStepIndex, we can intercept the user when they are *about to start* on a particular step
75 switch (ui.nextStepIndex) {
76 // in this case, I am displaying a summary on the last step of the wizard
77 case 4:
78 var oFormValues = {
79 name: $("#name").val(),
80 email: $("#email").val(),
81 username: $("#username").val(),
82 openid: undefined
83 };
84
85 $("#summary-name").children("td").text(oFormValues.name);
86 $("#summary-email").children("td").text(oFormValues.email);
87
88 if (oFormValues.username != "") {
89 $("#summary-username").show().children("td").text(oFormValues.username);
90 $("#summary-openid").hide().children("td").text("");
91 } else {
92 var $openid = $w.find("input:radio:checked[name=openid]");
93 oFormValues.openid = ($openid.length === 1) ? $openid.val() : $("#openid-other").val();
94
95 $("#summary-username").hide().children("td").text("");
96 $("#summary-openid").show().children("td").text(oFormValues.openid);
97 }
98 break;
99 }
100 });
101
102 // if the user clicks the openid link on step 3, (zero-index) cause the wizard to jump to the openid step
103 $("#openid").click(function () {
104 $w.jWizard("changeStep", 3);
105 return false;
106 });
107
108 // if an openid radio button is checked, blank out the `other` textbox
109 $w.find("input:radio[name=openid]").change(function (event) {
110 $("#openid-other").val("");
111 });
112 // if the `other` openid textbox is used, blank out the radio buttons
113 $("#openid-other").change(function (event) {
114 if (this.value != "") {
115 $w.find("input:radio[name=openid]").removeAttr("checked");
116 }
117 });
sum,我的搜狗怎么突然就没有用了。
算了 以上就是我的一点点经验,就不说了,吃饭时间到了,如果有需要的童鞋在做开发的时候,如果遇到问题,可以进行共同讨论,呵呵 共同进步嘛。
具体效果在这里 。
出处:http://www.cnblogs.com/damonlan
Q Q:*********
E_mail:Damon_lan@163.com or Dongcai.lan@hp.com
本博文欢迎大家浏览和转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,在『参考』的文章中,我会表明参考的文章来源,尊重他人版权。若您发现我侵犯了您的版权,请及时与我联系。