在jQuery的表變驗證插件中Validation-Engine是一款高質量的產品,提示效果非常精美,而且里面包含了AJAX驗證功能,見下圖:
驗證的例子:http://www.position-relative.net/creation/formValidator/
官方地址: http://www.position-absolute.com/articles/jquery-form-validator-because-form-validation-is-a-mess/
這個插件支持大部分的瀏覽器,但由於有使用到了css3的陰影和圓角樣式,所以在IE瀏覽器下無法看到圓角和陰影效果(IE 9 支持圓角效果)。
本文主要內容是:在ASP.NET中實現AJAX驗證功能。官方給出的Ajax驗證例子是PHP的實例,筆者在網站查閱的資料基本都是翻譯的官網,在ASP.NET中實現普通驗證是沒有問題的。但是,不能實現Ajax驗證,這應該是個bug。筆者研究了插件代碼,給出我自己的一種解決方案,要在ASP.NET實現這種效果,必須修改官方的主JS文件,當然同學們可以根據筆者的思路進行挖掘,歡迎補充!實現效果見下圖:
具體怎么使用這個插件,用搜索引擎能找到很多答案,筆者在這里簡單啰嗦一下,照顧下新同學。首先我們的下載插件包,上面是官方的下載地址。
插件包我們用的主要是三個文件:
jquery.validationEngine.js //插件主JS文件
jquery.validationEngine-cn.js //驗證規則JS文件
validationEngine.jquery.css //樣式表文件
當然,這個插件是jQuery的第三方插件,所以先要應用jquery的核心庫,筆者測試jquery 1.6.1 是沒有問題的。
1.引入jquery和插件js、css文件
<link href="Scripts/Validation-Engine/css/validationEngine.jquery.css" rel="stylesheet" type="text/css" />
<script src="Scripts/jquery-1.4.1-vsdoc.js" type="text/javascript"></script>
<script src="Scripts/Validation-Engine/js/jquery.validationEngine.js" type="text/javascript"></script>
<script src="Scripts/Validation-Engine/js/languages/jquery.validationEngine-zh_CN.js" type="text/javascript"></script>
2.初始化插件,在頁面head區域加入如下代碼:
$(document).ready(function() { $("#formID").validationEngine() ; //formID是你要驗證的表單ID })
3.添加表單元素驗證規則,常用的驗證規則上面官方地址有說明,還可以百度一下,這個不是難點。
<input id="Text3" type="text" class="validate[required,ajax[ajaxUsers]]" />
多個驗證多逗號隔開
4.驗證觸發
$("#formID").validationEngine({ inlineValidation: false, //在這里修改 success : false, alidationEventTriggers:"keyup blur", //這里增加了個keyup,也就是鍵盤按鍵起來就觸發驗證 promptPosition: "topRight", // 有5種模式 topLeft, topRight, bottomLeft, centerRight, bottomRight failure : function() { callFailFunction() } })
5.Ajax驗證,好了,這里是才是問題所在,在分析問題之前我們先看下Validation-Engine主JS文件是怎樣實現Ajax驗證的。打開jquery.validationEngine.js文件,Ctrl+F用查找"$.ajax"文檔中能找到兩處,我們要修改的是第二處,見下面折疊的官方源代碼,

1 $.ajax({ 2 type: options.ajaxFormValidationMethod, 3 url: rule.url, 4 cache: false, 5 dataType: "json", 6 data: "fieldId=" + field.attr("id") + "&fieldValue=" + field.val() + "&extraData=" + extraData + "&" + extraDataDynamic, 7 field: field, 8 rule: rule, 9 methods: methods, 10 options: options, 11 beforeSend: function() { 12 // build the loading prompt 13 var loadingText = rule.alertTextLoad; 14 if (loadingText) 15 methods._showPrompt(field, loadingText, "load", true, options); 16 }, 17 error: function(data, transport) { 18 methods._ajaxError(data, transport); 19 }, 20 success: function(json) { 21 22 // asynchronously called on success, data is the json answer from the server 23 var errorFieldId = json[0]; 24 //var errorField = $($("#" + errorFieldId)[0]); 25 var errorField = $($("input[id='" + errorFieldId +"']")[0]); 26 27 // make sure we found the element 28 if (errorField.length == 1) { 29 var status = json[1]; 30 // read the optional msg from the server 31 var msg = json[2]; 32 if (!status) { 33 // Houston we got a problem - display an red prompt 34 options.ajaxValidCache[errorFieldId] = false; 35 options.isError = true; 36 37 // resolve the msg prompt 38 if(msg) { 39 if (options.allrules[msg]) { 40 var txt = options.allrules[msg].alertText; 41 if (txt) 42 msg = txt; 43 } 44 } 45 else 46 msg = rule.alertText; 47 48 methods._showPrompt(errorField, msg, "", true, options); 49 } else { 50 if (options.ajaxValidCache[errorFieldId] !== undefined) 51 options.ajaxValidCache[errorFieldId] = true; 52 53 // resolves the msg prompt 54 if(msg) { 55 if (options.allrules[msg]) { 56 var txt = options.allrules[msg].alertTextOk; 57 if (txt) 58 msg = txt; 59 } 60 } 61 else 62 msg = rule.alertTextOk; 63 64 // see if we should display a green prompt 65 if (msg) 66 methods._showPrompt(errorField, msg, "pass", true, options); 67 else 68 methods._closePrompt(errorField); 69 } 70 } 71 errorField.trigger("jqv.field.result", [errorField, options.isError, msg]); 72 } 73 });
從上面官方源碼分析,這里的AJAX驗證機制也是基於jQuery的$.AJAX()方法。為了找到插件無法驗證的問題,筆者用jQuery手寫了一個$.AJAX()請求,來驗證jquery.validationEngine.js中的AJAX驗證。
5.1 第一步,創建后台處理程序,這里創建一般處理程序為例子,代碼如下:
public void ProcessRequest(HttpContext context) { context.Response.ContentType = "text/plain"; HttpContext _content = HttpContext.Current; string validateId = _content.Request["fieldId"]; string validateValue = _content.Request["fieldValue"]; string validateError = _content.Request["extraData"]; string str; if (validateValue == "abc") str = "{\"jsonValidateReturn\":[\"" + validateId + "\",\"" + validateError + "\",true]}"; else str = "{\"jsonValidateReturn\":[\"" + validateId + "\",\"" + validateError + "\",false]}"; context.Response.Write(str); }
這里注意了:在AJAX驗證的時候,會POST三個核心參數到后台,fieldId、fieldValue、extraData,當然還可自定義其它的參數傳遞過來
5.2 第二步,創建一個aspx頁面仿照Validation-Engine的JS寫個AJAX請求,代碼如下:

1 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="FormValidation.aspx.cs" Inherits="DemoWeb.FormValidation" %> 2 3 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 4 5 <html xmlns="http://www.w3.org/1999/xhtml"> 6 <head runat="server"> 7 <title>jQuery表單驗證 - Validation-Engine</title> 8 <link href="Scripts/Validation-Engine/css/validationEngine.jquery.css" rel="stylesheet" type="text/css" /> 9 <script src="Scripts/jquery-1.4.1-vsdoc.js" type="text/javascript"></script> 10 <script src="Scripts/Validation-Engine/js/jquery.validationEngine.js" type="text/javascript"></script> 11 <script src="Scripts/Validation-Engine/js/languages/jquery.validationEngine-zh_CN.js" type="text/javascript"></script> 12 13 <script type="text/javascript"> 14 $(document).ready(function () { 15 $("#formID").validationEngine({ 16 ajaxFormValidation: true 17 }); 18 19 $.ajax({ 20 type: "get", 21 url: "AjaxBackstage/AjaxValidation.ashx", 22 cache: false, 23 data: { "fieldId": "Text4", "fieldValue": "haha", "extraData": "nowtime2012" }, 24 dataType: "json", 25 error: function (XMLHttpRequest, textStatus, errorThrown) { 26 alert("錯誤!XMLHttpRequest.status=" + XMLHttpRequest.status + ",XMLHttpRequest.readyState=" + XMLHttpRequest.readyState + ",textStatus=" + textStatus); 27 }, 28 success: function (json) { 29 alert("你好,成功了!"+json.jsonValidateReturn[0] + ", " + json.jsonValidateReturn[1] + "," + json.jsonValidateReturn[2]); 30 } 31 }); 32 33 }); 34 35 </script> 36 37 </head> 38 <body> 39 <form id="formID" runat="server"> 40 <h2> 41 jQuery - Validation-Engine - Ajax驗證 42 </h2> 43 <br /> 44 <p> 45 Ajax:<input id="Text3" type="text" class="validate[required,ajax[ajaxUsers]]" /> 46 </p> 47 <p> 48 Ajax:<input id="Text4" type="text" class="validate[ajax[ajaxUsers]]"/> 49 </p> 50 51 <p> 52 Ajax:<input id="Text1" type="text" class="validate[required]"/> 53 </p> 54 55 </form> 56 </body> 57 </html>
url: "AjaxBackstage/AjaxValidation.ashx" 這里指向剛才創建的一般處理程序
調試結果返回的是正確的json格式的數據會執行 succes下面的函數,否則執行error下面的函數,下面看一下效果
返回出現錯誤時,是無法完成Validation-Engine的AJAX驗證的。這里顯示顯示錯誤是"pars error" 編譯器錯誤,根本原因還是返回數據的問題。下面是后台處理程序的返回數據的部分,筆者測試,字段不能用單引號,否則見上圖效果,所以這里用傳遞的數據用雙引號引起來。
1 string str; 2 if (validateValue == "abc") 3 str = "{\"jsonValidateReturn\":[\"" + validateId + "\",\"" + validateError + "\",true]}"; 4 else 5 str = "{\"jsonValidateReturn\":[\"" + validateId + "\",\"" + validateError + "\",false]}"; 6 //if (validateValue == "abc") 7 // str = "{'jsonValidateReturn':['" + validateId + "','" + validateError + "',true]}"; 8 //else 9 // str = "{'jsonValidateReturn\":['" + validateId + "','" + validateError + "',false]}";
數據請求成功:
5.3 第三步,根據上面的例子給jquery.validationEngine.js文件動動“手術”,參考上面第5條。jsonValidateReturn ?對,關鍵就在這個地方,官方版本是PHP的例子在傳遞的json數據有點小區別,導致json[0]獲取不到數據。所以在本例中json.jsonValidateReturn[index]獲取的數據才正常。當然你不喜歡這個名稱jsonValidateReturn也可以自己定義一個名稱,但前提必須是后台傳遞數據時的名稱和這里的名稱是一致的。
// 異步調用成功,數據是從服務器的JSON答案 // 改動地方,原來jvar errorFieldId =json[0] 在asp.Net中是獲取不到數據的 // 改成下面的方式,注意jsonValidateReturn這里名稱定死了,在AJAX后台返回數據時必須和jsonValidateReturn一致 // {"jsonValidateReturn":["validateId","validateError","true"]} var errorFieldId = json.jsonValidateReturn[0]; //改動的地方 //var errorField = $($("#" + errorFieldId)[0]); var errorField = $($("input[id='" + errorFieldId +"']")[0]); // 確保我們找到元素 if (errorField.length == 1) { var status = json.jsonValidateReturn[2]; //改動的地方 // 從服務器讀取的可選MSG var msg = json.jsonValidateReturn[1]; //改動的地方 if (!status) { // Houston,我們有一個問題 - 顯示一個紅色的提示 options.ajaxValidCache[errorFieldId] = false; options.isError = true;
5.4 第四步,在語言文件中自定義規則,官方語言包中有中文語言文件調用jquery.validationEngine-zh_CN.js,這里筆者添加一個“ajaxUsers”規則。
// --- CUSTOM RULES -- Those are specific to the demos, they can be removed or changed to your likings "ajaxUsers": { "url": "AjaxBackstage/AjaxValidation.ashx", // "validate.action", "validate.action"ajax驗證用戶名,會post如下參數:validateError ajaxUser;validateId user;validateValue cccc "alertTextOk": "* 帳號可以使用.", "alertTextLoad": "* 檢查中, 請稍后...", "alertText": "* 帳號不能使用." }, "ajaxUserCall": { "url": "ajaxValidateFieldUser", // you may want to pass extra data on the ajax call //"extraData": "name=eric", "alertText": "* 此名稱已被其他人使用", "alertTextLoad": "* 正在確認名稱是否有其他人使用,請稍等。" },
OK,試試看驗證是不是能成功了呢。。。
最后,總結出來一點經驗,拿出來分享。“從事物的本質中尋找問題的答案!”。
說明:本文系原創,轉載請注明出處!http://www.cnblogs.com/skylinetour/