深入理解ajax系列第四篇——FormData
现代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'));//false
oData1.append('a',1);
console.log(oData1.has('a'));//true
console.log(oData1.get('a'));//1
oData1.set('a',2);
oData1.append('a',1);
console.log(oData1.get('a'));//2
console.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'));//true
console.log(oData1.get('a'));//1
oData1.append('a',2);
console.log(oData1.get('a'));//1
console.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>