前面的话
现代Web应用中频繁使用的一项功能就是表单数据的序列化,XMLHttpRequest 2级为此定义了FormData类型。FormData为序列化表单以及创建与表单格式相同的数据提供了便利。本文将先介绍表单编码,然后过渡到表单序列化,最后引出FormData的核心概念
表单编码
当用户提交表单时,表单中的数据(每个表单元素的名字和值)编码到一个字符串中并随请求发送。默认情况下,HTML表单通过POST方法发送给服务器,而编码后的表单数据则用做请求主体
对表单数据使用的编码方案相对简单:对每个表单元素的名字和值执行普通的URL编码(使用十六进制转义码替换特殊字符),使用等号把编码后的名字和值分开,并使用"&"符号分开名/值对。一个简单表单的编码如下所示
find=pizza&zipcode=01234&radius=1km
表单数据编码格式有一个正式的MIME类型
application/x-www-form-urlencoded
当使用POST方法提交这种顺序的表单数据时,必须"Content-Type"请求头为这个值
[注意]这种类型的编码并不需要HTML表单,在Ajax应用中,希望发送给服务器的很可能是一个javascript对象
前面展示的数据变成javascript对象的表单编码形式可能是:
{find: "pizza", zipcode: 01234, radius: "1km"}
表单编码在Web上如此广泛使用,同时所有服务器端的编程语言都能得到良好的支持,所以非表单数据的表单编码通常也是容易实现的事情
下面代码展示了如何实现对象属性的表单编码
function encodeFormData(data){ ???if (!data) return ""; ???//一直返回字符串 ???var pairs = []; ???????????//用于保存名值对 ???for(var name in data){ ????????if (!data.hasOwnProperty(name)){ ???????????continue; ???????//跳过继承属性 ???????} ???????if (typeof data[name] === "function"){ ???????????continue; ????????//跳过方法 ????????} ???????var value = data[name].toString(); ???//把值转换成字符串 ???????name = encodeURIComponent(name.replace("%20", "+")); //编码名字 ???????value = encodeURIComponent(value.replace("%20", "+"));//编码值 ???????pairs.push(name + "=" + value); // 存入名值对 ????} ???return pairs.join(‘&‘); //返回使用‘&‘连接的名值对}
var data = {name:‘小火柴‘,age:28,sender:‘male‘};//name=%E5%B0%8F%E7%81%AB%E6%9F%B4&age=28&sender=male ???console.log(encodeFormData(data)); ???
表单序列化
随着Ajax的出现,表单序列化已经成为一种常见需求。在javascript中,可以利用表单字段的type属性,连同name和value属性一起实现对表单的序列化。在编写代码之前,有必须先搞清楚在表单提交期间,浏览器是怎样将数据发送给服务器的
1、对表单字段的名称和值进行URL编码,使用和号(&)分隔
2、不发送禁用的表单字段
3、只发送勾选的复选框和单选按钮
4、不发送type为"reset"和"button"的按钮
5、多选选择框中的每个选中的值単独一个条目
6、在单击提交按钮提交表单的情况下,也会发送提交按钮;否则,不发送提交按钮。也包括type为"image"的<input>元素
7、<select>元素的值,就是选中的<option>元素的value特性的值。如果<option>元素没有value特性,则是<option>元素的文本值
在表单序列化过程中,一般不包含任何按钮字段,因为结果字符串很可能是通过其他方式提交的。除此之外的其他上述规则都应该遵循
在下面表单序列化serialize()函数中,首先定义了一个名为parts的数组,用于保存将要创建的字符串的各个部分。然后,通过for循环迭代每个表单字段,并将其保存在field变量中。在获得了一个字段的引用之后,使用switch语句检测其type属性
序列化过程中最麻烦的就是<select>元素,它可能是单选框也可能是多选框。为此,需要遍历控件中的每一个选项,并在相应选项被选中的情况下向数组中添加一个值。对于单选框,只可能有一个选中项,而多选框则可能有零或多个选中项。这里的代码适用于这两种选择框,至于可选项的数量则是由浏览器控制的。在找到一个选中项之后,需要确定使用什么值。如果不存在value特性,或者虽然存在该特性,但值为空字符串,都要使用选项的文本来代替。为检査这个特性,在DOM兼容的浏览器中需要使用hasAttribute()方法,而在IE7-中需要使用特性的specified属性
如果表单中包含<fieldset>元素,则该元素会出现在元素集合中,但没有type属性。因此,如果type属性未定义,则不需要对其进行序列化。同样,对于各种按钮以及文件输入字段也是如此(文件输入字段在表单提交过程中包含文件的内容;但是,这个字段是无法模仿的,序列化时一般都要忽略)
对于单选按钮和复选框,要检查其checked属性是否被设置为false,如果是则退出switch语句。如果checked属性为true,则继续执行default语句,即将当前字段的名称和值进行编码,然后添加到parts数组中。函数的最后一步,就是使用join()格式化整个字符串,也就是用和号来分隔每一个表单字段
最后,serialize()函数会以査询字符串的格式输出序列化之后的字符串
function serialize(form){ ???????????var parts = [],field = null,option,optValue; ???for (var i=0, len=form.elements.length; i < len; i++){ ???????field = form.elements[i]; ???????switch(field.type){ ???????????//单选或多选的<select>控件 ???????????case "select-one": ???????????case "select-multiple": ???????????????//如果该<select>控件设置为name属性 ?????????????????if (field.name.length){ ???????????????????for (var j=0,optLen = field.options.length; j < optLen; j++){ ???????????????????????//选择<option>控件 ???????????????????????option = field.options[j]; ???????????????????????//如果该<option>控件被选中 ???????????????????????if (option.selected){ ???????????????????????????optValue = ""; ???????????????????????????//测试<option>控件的value属性,如果没有设置,则读取其text属性 ???????????????????????????//IE7-浏览器不支持hasAttribute() ???????????????????????????if (option.hasAttribute){ ???????????????????????????????optValue = (option.hasAttribute("value") ? option.value : option.text); ???????????????????????????} else { ???????????????????????????????optValue = (option.attributes["value"].specified ? option.value : option.text); ???????????????????????????} ???????????????????????????//将键和值分别进行编码并用‘=‘连接起来 ???????????????????????????parts.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(optValue)); ???????????????????????} ???????????????????} ???????????????} ???????????????break; ??????????????????????????case undefined: ????//fieldset ???????????case "file": ???????//file input ???????????case "submit": ?????//submit button ???????????case "reset": ??????//reset button ???????????case "button": ?????//custom button ???????????????break; ???????????????????????????case "radio": ??????//radio button ???????????case "checkbox": ???//checkbox ???????????????//如果没有选中项 ???????????????if (!field.checked){ ???????????????????break; ???????????????} ?????????????????????????????default: ?????????????????????????????if (field.name.length){ ???????????????????parts.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(field.value)); ???????????????} ???????} ???} ???????????return parts.join("&");}
<form name="form" action="test.php"> ???<input type="text" value="123" name="text"> ???<select name="color" ?multiple> ???????<option>红</option> ???????<option>绿</option> ???????<option>蓝</option> ???</select> ???<input type="radio" name="gender" id="male" value="male"><label for="male">男</label> ???<input type="radio" name="gender" id="female" value="female"><label for="female">女</label> ???<input type="checkbox" name="time" value="12" id="t12"><label for="t12">12小时</label> ???<input type="checkbox" name="time" value="24" id="t24"><label for="t24">24小时</label> ???<button name="btn" type="button">按钮</button></form><div id="result"></div><script>var oForm = document.forms.form;oForm.onchange = function(e){ ???e = e || event; ???result.innerHTML = serialize(form);}</script>
FormData
当HTML表单同时包含文件上传元素和其他元素时,浏览器不能使用普通的表单编码而必须使用称为“multipart/form-data”的特殊Content-Type来用POST方法提交表单。这种编码包括使用长“边界”字符串把请求主体分离成多个部分。对于文本数据,手动创建“multipart/form-data”请求主体是可能的,但很复杂
XMLHttpRequest 2级为此定义了FormData类型。FormData为序列化表单以及创建与表单格式相同的数据(用于通过XHR传输)提供了便利
[注意]IE9-浏览器不支持
【构造函数】
new FormData (form? : HTMLFormElement)
可选参数form表示一个HTML表单元素,可以包含任何形式的表单控件,包括文件输入框
【append()】
append()方法用于给当前FormData对象添加一个键/值对
void append(DOMString name, Blob value, optional DOMString filename);void append(DOMString name, DOMString value);
参数值name表示字段名称;参数值value表示字段值;参数值filename(可选)用于指定文件的文件名,当value参数被指定为一个Blob对象或者一个File对象时,该文件名会被发送到服务器上,对于Blob对象来说,这个值默认为"blob"
【其他不常用方法】
get():通过get(key)/getAll(key)来获取对应的value
set():通过set(key,value)修改数据,如果指定的key不存在则新增一条,如果存在,则修改对应的value值
has():通过has(key)来判断是否对应的key值
delete():通过delete(key)来删除数据
[注意]以上4个不常用方法,IE浏览器都不支持
var oData1 = new FormData();console.log(oData1.has(‘a‘));//falseoData1.append(‘a‘,1);console.log(oData1.has(‘a‘));//trueconsole.log(oData1.get(‘a‘));//1oData1.set(‘a‘,2);oData1.append(‘a‘,1);console.log(oData1.get(‘a‘));//2console.log(oData1.getAll(‘a‘));//["2", "1"]oData1.delete(‘a‘);console.log(oData1.get(‘a‘));//null
<form action="#" name="form1"> ???<input type="text" value="1" name="a"></form><script>var oData1 = new FormData(document.forms.form1);console.log(oData1.has(‘a‘));//trueconsole.log(oData1.get(‘a‘));//1oData1.append(‘a‘,2);console.log(oData1.get(‘a‘));//1console.log(oData1.getAll(‘a‘));//[‘1‘,‘2‘]</script>
一般地,我们使用FormData()构造函数创建FormData对象,然后按需多次调用这个对象的append()方法把个体“部分”(可以是字符串、File或Blob对象)添加到请求中。最后,把FormData对象传递给send()方法,通过XHR对象将其发送到服务器
[注意]multipart/form-data只能用于post方式
<form action="#" name="form1"><select name="a"> ???<option value="1">1</option> ???<option value="2">2</option> ???<option value="3">3</option></select></form><div id="result"></div><script>var oForm = document.forms.form1;oForm.onchange = function(){ ???//创建xhr对象 ???var xhr; ???if(window.XMLHttpRequest){ ???????xhr = new XMLHttpRequest(); ???}else{ ???????xhr = new ActiveXObject(‘Microsoft.XMLHTTP‘); ???} ???//异步接受响应 ???xhr.onreadystatechange = function(){ ???????if(xhr.readyState == 4){ ???????????if(xhr.status == 200){ ???????????????//实际操作 ???????????????result.innerHTML = xhr.responseText; ???????????} ???????} ???} ???//发送请求 ???xhr.open(‘post‘,‘t1.php‘ ,true); ???xhr.send(new FormData(form1)); }</script>
深入理解ajax系列第四篇
原文地址:http://www.cnblogs.com/yujihaia/p/7464503.html