深入理解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>

results matching ""

    No results matching ""