Zepto源码分析-form模块

//     Zepto.js
//     (c) 2010-2015 Thomas Fuchs
//     Zepto.js may be freely distributed under the MIT license.

;(function($){

/**
* 序列表单内容为JSON数组
* 返回类似[{a1:1},{a2:2}]的数组
* @returns {Array}
*/
$.fn.serializeArray = function() {
var name, type, result = [],

//{name:value}形式加入到结果数组中
add = function(value) {
//value是数组，递归添加到数组中
//注意这里的写法    value.forEach(add)   将value数组递归的每一项传入add
// 如 {a:[1,2,3]} -->  [{a:1},{a:2},{a:3}]
if (value.forEach) return value.forEach(add)
result.push({ name: name, value: value })
}

//
if (this[0]) $.each(this[0].elements, function(_, field){
type = field.type, name = field.name

//排除fieldset，禁用元素，submit,reset,button，file和未被选中的radio，checkbox
//原因是这些元素不需要传递给服务器
if (name && field.nodeName.toLowerCase() != 'fieldset' &&
!field.disabled && type != 'submit' && type != 'reset' && type != 'button' && type != 'file' &&

((type != 'radio' && type != 'checkbox') || field.checked))

//{name:value}形式加入到结果数组中
add($(field).val())
})
return result
}

/**
* 序列表表单内容为查询字符串
*  转换成 a=1&b=2
* @returns {string}
*/
$.fn.serialize = function(){
var result = []
this.serializeArray().forEach(function(elm){
// 每个key-value，都保守URI编码
result.push(encodeURIComponent(elm.name) + '=' + encodeURIComponent(elm.value))
})
return result.join('&')
}

/**
* 提交表单
* @param callback
* @returns {*}
*/
$.fn.submit = function(callback) {
//0 in arguments 判断是否传了回调函数
//      这里不应用bind，所有事件应该统一用on
//传了回调，就当成绑定submit事件
if (0 in arguments) this.bind('submit', callback)
//没有传回调，当成直接提交
else if (this.length) {//有表单元素
var event = $.Event('submit')

//第一个表单直接触发submit事件
//如果绑定过submit事件，此处会执行submit绑定函数
//注意，这里只是抛出事件，并不会提交表单
this.eq(0).trigger(event)

//如果未阻止浏览器默认事件，调用document.forms[0].submit()执行默认处理
//document.forms[0].submit()提交表单
if (!event.isDefaultPrevented()) this.get(0).submit()
}
return this
}

})(Zepto)