jquery.form.js是一个form插件,支持ajax表单提交和ajax文件上传,其引用方式如“8a64e7d4beec6ea6dea0513bde1f3c2b2cacc6d41bbb37262a98f745aa00fbf0”。
本文操作环境:windows7系统、jquery1.6.2版、dell g3电脑
jquery.form.js是什么?
jquery.form.js使用
jquery.form.js是一个form插件,支持ajax表单提交和ajax文件上传。
<!doctype html><html><head> <meta name="viewport" content="width=device-width" /> <title>index</title> <script src="~/scripts/jquery-1.6.2.js"></script> <script src="~/scripts/jquery.form.js"></script></head><body> <div> <form id="ajaxform" method="post" action="/home/index" enctype="multipart/form-data"> <input type="text" name="name" /> <input type="text" name="sex" /> <input type="file" name="file" /> <button type="submit" id="btnsubmit">提交1</button> </form> <button id="btnbutton" type="button">提交2</button> </div> <script type="text/javascript"> $(function () { $("#ajaxform").ajaxform(function () { alert("提交成功1"); }); $("#ajaxform").submit(function () { $(this).ajaxsubmit(function () { alert("提交成功1"); }); return false; }); $("#btnbutton").click(function () { $("#ajaxform").ajaxsubmit(function () { alert("提交成功2"); }); return false; }); }); </script></body></html>
ajaxform 增加所有需要的事件监听器,为ajax提交表单做准备。ajaxform并不能提交表单。在document的ready函数中,使用ajaxform来为ajax提交表单进行准备。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个options对象。 $("#formid").ajaxform();
ajaxsubmit 使用ajax提交表单。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个options对象。 $("#formid").ajaxsubmit();
或
$("#formid").submit(function(){
$(this).ajaxsubmit();
return false;
});
formserialize 将表单串行化(或序列化)为一个查询字符串。这个方法将返回以下格式的字符串:name1=value1&name2=value2。 无 $("#formid").formserialize();
fieldserialize 将表单的字段元素串行化(或序列化)为一个查询字符串。当只有部分表单字段需要进行串行化(或序列化)时,使用这个就很方便了。返回以下格式的字符串:name=value1&name2=value2。 无 $("#formid .specialfields").fieldserialize();
fieldvalue 返回匹配插入数组中的表单元素值。该方法以数组的形式返回数据。如果元素值被判定可能无效,则数组为空。 无 $("#formid :password").fieldvalue();
resetform 将表单恢复到初始状态。 无 $("#formid").resetform();
clearform 清除表单元素。该方法将所有的text、password、textarea置空,清除select元素中的选定,以及所有radio按钮和checkbox按钮重置为非选定状态。 无 $("#formid").clearform();
clearfields 清除字段元素。只有部分表单元素需要清除时方便使用。 无 $("#formid .specialfields").clearfields();
options对象
ajaxform和ajaxsubmit都支持众多的选项参数,这些选项参数可以使用一个options对象来提供。
target 指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jquery选择器字符串、一个jquery对象、一个dom元素。 默认值:null
url 指定提交表单数据的url。 默认值:表单的action属性值
type 指定提交表单数据的方法(method):“get”或“post”。 默认值:get
beforesubmit 表单提交前被调用的回调函数。如果回调函数返回false表单将不被提交。回调函数带三个调用参数:数组形式的表单数据,jquery表单对象,以及传入ajaxform/ajaxsubmit中的options对象。 默认值:null
success 表单成功提交后调用的回调函数。然后datatype选项值决定传回responsetext还是responsexml的值。 默认值:null
datatype 返回的数据类型:null、"xml"、"script"、"json"其中之一。 默认值:null
resetform 表示如果表单提交成功是否进行重置。 默认值:null
clearform 表示如果表单提交成功是否清除表单数据。
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);}
推荐学习:《jquery视频教程》
以上就是jquery.form.js是什么的详细内容。