jquery-form是指jQuery表單庫,是一個表單非同步提交外掛,可容易地、無侵入地升級HTML表單以支援Ajax;該外掛有兩個核心方法:ajaxForm()和ajaxSubmit(),集合了從控制表單元素到決定如何管理提交程序的功能。
本教學操作環境:windows7系統、jquery3.3.1版本、Dell G3電腦。
jquery-form是什麼
jquery-form是指jQuery表單庫,是一個基於jQuery的表單非同步提交外掛,用於處理表單AJAX提交,使得表單AJAX提交簡單、容易,且能完整控制提交過程和處理結果,不需要任何特殊標籤輔助,不影響原表單結構,只要使用該庫就能使普通表單平滑升級為ajax提交表單。
外掛優點
簡簡單單幾句程式碼,我們就可以實現表單的提交,並且可靈活通過ajaxSubmit()函數基於任何事件的觸發實現表單非同步提交。
支援檔案上傳功能,並在新瀏覽器中支援進度條更新。
與jQuery庫完美結合,支援jQuery.ajax()函數觸發的各種事件,支援jQuery.ajax()中所傳遞的引數。
jquery-form可以非常容易地、無侵入地升級HTML表單以支援Ajax。jQuery Form有兩個核心方法 -- ajaxForm() 和 ajaxSubmit(), 它們集合了從控制表單元素到決定如何管理提交程序的功能。另外,外掛還包括其他的一些方法: formToArray()、formSerialize()、fieldSerialize()、fieldValue()、clearForm()、clearFields() 和 resetForm()等。
下載地址: http://malsup.com/jquery/form/#download
核心方法 -- ajaxForm() 和 ajaxSubmit()
$('#myForm').ajaxForm(function() { $('#output1').html("提交成功!歡迎下次再來!").show(); }); $('#myForm2').submit(function() { $(this).ajaxSubmit(function() { $('#output2').html("提交成功!歡迎下次再來!").show(); }); return false; //阻止表單預設提交 });
通過Form外掛的兩個核心方法,都可以在不修改表單的HTML程式碼結構的情況下,輕易地將表單的提交方式升級為Ajax提交方式
ajaxForm() 和 ajaxSubmit() 都能接受0個或1個引數,當為單個引數時,該引數既可以是一個回撥函數,也可以是一個options物件,上面的例子就是回撥函數,下面介紹options物件,使得它們對錶單擁有更多的控制權
var options = { target: '#output', //把伺服器返回的內容放入id為output的元素中 beforeSubmit: showRequest, //提交前的回撥函數 success: showResponse, //提交後的回撥函數 //url: url, //預設是form的action, 如果申明,則會覆蓋 //type: type, //預設是form的method(get or post),如果申明,則會覆蓋 //dataType: null, //html(預設), xml, script, json...接受伺服器端返回的型別 //clearForm: true, //成功提交後,清除所有表單元素的值 //resetForm: true, //成功提交後,重置所有表單元素的值 timeout: 3000 //限制請求的時間,當請求大於3秒後,跳出請求 } function showRequest(formData, jqForm, options){ //formData: 陣列物件,提交表單時,Form外掛會以Ajax方式自動提交這些資料,格式如:[{name:user,value:val },{name:pwd,value:pwd}] //jqForm: jQuery物件,封裝了表單的元素 //options: options物件 var queryString = $.param(formData); //name=1&address=2 var formElement = jqForm[0]; //將jqForm轉換為DOM物件 var address = formElement.address.value; //存取jqForm的DOM元素 return true; //只要不返回false,表單都會提交,在這裡可以對錶單元素進行驗證 }; function showResponse(responseText, statusText){ //dataType=xml var name = $('name', responseXML).text(); var address = $('address', responseXML).text(); $("#xmlout").html(name + " " + address); //dataType=json $("#jsonout").html(data.name + " " + data.address); }; $("#myForm").ajaxForm(options); $("#myForm2").submit(funtion(){ $(this).ajaxSubmit(options); return false; //阻止表單預設提交 });
表單提交之前進行驗證: beforeSubmit會在表單提交前被呼叫,如果beforeSubmit返回false,則會阻止表單提交
beforeSubmit: validate function validate(formData, jqForm, options) { //在這裡對錶單進行驗證,如果不符合規則,將返回false來阻止表單提交,直到符合規則為止 //方式一:利用formData引數 for (var i=0; i < formData.length; i++) { if (!formData[i].value) { alert('使用者名稱,地址和自我介紹都不能為空!'); return false; } } //方式二:利用jqForm物件 var form = jqForm[0]; //把表單轉化為dom物件 if (!form.name.value || !form.address.value) { alert('使用者名稱和地址不能為空,自我介紹可以為空!'); return false; } //方式三:利用fieldValue()方法,fieldValue 是表單外掛的一個方法,它能找出表單中的元素的值,返回一個集合。 var usernameValue = $('input[name=name]').fieldValue(); var addressValue = $('input[name=address]').fieldValue(); if (!usernameValue[0] || !addressValue[0]) { alert('使用者名稱和地址不能為空,自我介紹可以為空!'); return false; } var queryString = $.param(formData); //組裝資料 //alert(queryString); //類似 : name=1&add=2 return true; }
【推薦學習:、】
以上就是jquery-form是什麼的詳細內容,更多請關注TW511.COM其它相關文章!