From 9ad3778610c9fab685e44c7b6f673a952f49aef8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 2 Jul 2014 16:10:59 +0800
Subject: [PATCH 01/24] add upload plugin

---
 js/upload.js | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 155 insertions(+)
 create mode 100644 js/upload.js

diff --git a/js/upload.js b/js/upload.js
new file mode 100644
index 00000000..011a14da
--- /dev/null
+++ b/js/upload.js
@@ -0,0 +1,155 @@
+(function($) {
+  // 注册一个ajax prefilter,创建新的type类型upload，检测ajax方法调用的入参有没有upload
+  $.ajaxPrefilter(function(options, origOptions, jqXHR) {
+    if (options.upload) {
+      options.originalURL = options.url;
+      return 'upload';
+    }
+  });
+
+  // 为dataType为upload的请求类型注册一个 ajax transport
+  // 但他只在ajax方法调用时传入不为空的file属性才会激活.file属性是一个file input类数组
+  $.ajaxTransport('upload', function(options, origOptions, jqXHR) {
+    var form = null,
+      iframe = null,
+      name = 'upload-' + +new Date(),
+      files = $(options.files).filter(':file:enabled'),
+      markers = null,
+      accepts = null;
+
+    // 成功提交隐藏iframe内的file input后或者放弃提交后执行，使所有页面上的变化恢复原状。
+    function cleanUp() {
+      files.each(function(k, v) {
+        var $file = $(v);
+        $file.data('clone').replaceWith($file);
+      });
+      form.remove();
+      iframe.one("load", function() { iframe.remove(); });
+      iframe.attr("src", "javascript:false;");
+    }
+
+    // 从jquery ajax 的dataTypes队列中弹出第一个值，使之后数据的处理类型基于服务器返回的数据类型
+    options.dataTypes.shift();
+
+    // 获取需要额外传输的数据
+    var extraData = (options.data = origOptions.data);
+
+    if (files.length) {
+      form = $('<form enctype="multipart/form-data" method="post"></form>').hide().attr({action: options.originalURL, target: name});
+
+      // 提交文件同时如果需要额外传输一些数据，直接放在ajax调用的data参数里
+      // 但因为是附加为iframe表单的隐藏域里传值，数据不能被序列化为string。processData属性设为false即可。
+      if (typeof(extraData) === 'string' && extraData.length > 0) {
+        throw Error('额外传输的数据不应该被序列化（serialized）');
+      }
+      $.each(extraData || {}, function(k, v) {
+        if ($.isPlainObject(v)) {
+          k = v.name;
+          v = v.value;
+        }
+        $('<input type="hidden"/>').attr({name:  k, value: v}).appendTo(form);
+      });
+
+      $('<input type="hidden" name="X-Requested-With" value="IFrame"/>').appendTo(form);
+      if (options.dataTypes[0] && options.accepts[options.dataTypes[0]]) {
+        accepts = options.accepts[options.dataTypes[0]] +
+                  (options.dataTypes[0] !== "*" ? ", */*; q=0.01" : "");
+      } else {
+        accepts = options.accepts["*"];
+      }
+      $('<input type="hidden" name="X-HTTP-Accept">').attr('value', accepts).appendTo(form);
+
+      markers = files.after(function(idx) {
+        var $this = $(this),
+          $clone = $this.clone().prop('disabled', true);
+        $this.data('clone', $clone);
+        return $clone;
+      }).next();
+      files.appendTo(form);
+
+      return {
+        // $.ajax()内部通过send方法发具体请求。自定义一个
+        send: function(headers, completeCallback) {
+          iframe = $('<iframe src="javascript:false;" name="' + name + '" id="' + name + '" style="display:none"></iframe>');
+
+          // iframe被注入到DOM后触发第一个load事件，已准备提交文件
+          iframe.one('load', function() {
+            // The second load event gets fired when the response to the form
+            // submission is received. The implementation detects whether the
+            // actual payload is embedded in a `<textarea>` element, and
+            // prepares the required conversions to be made in that case.
+            // 第二个load在收到服务器响应表单提交后。
+            iframe.one("load", function() {
+              var doc = this.contentWindow ? this.contentWindow.document :
+                (this.contentDocument ? this.contentDocument : this.document),
+                root = doc.documentElement ? doc.documentElement : doc.body,
+                textarea = root.getElementsByTagName("textarea")[0],
+                type = textarea && textarea.getAttribute("data-type") || null,
+                status = textarea && textarea.getAttribute("data-status") || 200,
+                statusText = textarea && textarea.getAttribute("data-statusText") || "OK",
+                content = {
+                  html: root.innerHTML,
+                  text: type ?
+                    textarea.value :
+                    root ? (root.textContent || root.innerText) : null
+                };
+              cleanUp();
+              completeCallback(status, statusText, content, type ?
+                ('Content-Type: ' + type) :
+                null);
+            });
+
+            form[0].submit();
+          });
+
+          $('body').append(form, iframe);
+        },
+
+        abort: function() {
+          if (iframe !== null) {
+            iframe.unbind('load').attr('src', 'javascript:false;');
+            cleanUp();
+          }
+        }
+      };
+    }
+  });
+
+  $.extend({
+    upload: function(opt) {
+      var $fileinputs = opt.$fileinputs;
+      $.each($fileinputs, function(k, v){
+        var type = $(v).prop('type');
+        if ( type != 'file') {
+          throw Error('upload——传入控件类型应为file，实际有type为' + type + '的控件!');
+        }
+      })
+
+      $fileinputs.on('change', function(e) {
+        var fileinput = this
+          , data = opt.data
+          , param = {
+            type: 'post',
+            dataType: 'json',
+            files: fileinput,
+            upload: true
+          };
+        if (typeof opt.data == 'function') {
+          data = opt.data.call(this);
+        }
+        if (data) {
+          $.extend(param, {
+            data: data,
+            processData: false
+          })
+        }
+        $.ajax(opt.api, param).success(function(data) {
+          if (typeof opt.success == 'function') {
+            opt.success.call(fileinput, data);
+          }
+        });
+      });
+    }
+  })
+
+})(jQuery);

From 98c8bfa74c409412ec4acb76a835b37a16f82d01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 2 Jul 2014 17:40:48 +0800
Subject: [PATCH 02/24] deal with jshint

---
 js/upload.js | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 011a14da..79b030a1 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -1,3 +1,4 @@
+/* jshint ignore:start */
 (function($) {
   // 注册一个ajax prefilter,创建新的type类型upload，检测ajax方法调用的入参有没有upload
   $.ajaxPrefilter(function(options, origOptions, jqXHR) {
@@ -12,7 +13,7 @@
   $.ajaxTransport('upload', function(options, origOptions, jqXHR) {
     var form = null,
       iframe = null,
-      name = 'upload-' + +new Date(),
+      name = 'upload-' + (+new Date()),
       files = $(options.files).filter(':file:enabled'),
       markers = null,
       accepts = null;
@@ -25,7 +26,7 @@
       });
       form.remove();
       iframe.one("load", function() { iframe.remove(); });
-      iframe.attr("src", "javascript:false;");
+      iframe.attr("src", "javascript:false");
     }
 
     // 从jquery ajax 的dataTypes队列中弹出第一个值，使之后数据的处理类型基于服务器返回的数据类型
@@ -70,7 +71,7 @@
       return {
         // $.ajax()内部通过send方法发具体请求。自定义一个
         send: function(headers, completeCallback) {
-          iframe = $('<iframe src="javascript:false;" name="' + name + '" id="' + name + '" style="display:none"></iframe>');
+          iframe = $('<iframe src="javascript:false" name="' + name + '" id="' + name + '" style="display:none"></iframe>');
 
           // iframe被注入到DOM后触发第一个load事件，已准备提交文件
           iframe.one('load', function() {
@@ -107,7 +108,7 @@
 
         abort: function() {
           if (iframe !== null) {
-            iframe.unbind('load').attr('src', 'javascript:false;');
+            iframe.unbind('load').attr('src', 'javascript:false');
             cleanUp();
           }
         }
@@ -153,3 +154,4 @@
   })
 
 })(jQuery);
+/* jshint ignore:end */

From 140504ed35efc1e4b850cf816b3281c1ca4790f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 2 Jul 2014 17:41:00 +0800
Subject: [PATCH 03/24] init docs

---
 docs/templates/upload.jade | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/templates/upload.jade

diff --git a/docs/templates/upload.jade b/docs/templates/upload.jade
new file mode 100644
index 00000000..7cd4e3e6
--- /dev/null
+++ b/docs/templates/upload.jade
@@ -0,0 +1,13 @@
+extends base
+
+block title
+  title Tag 
+
+block sidebar
+  +sidebar('upload')
+
+block content
+
+  h2.sui-page-header 开发者文档
+
+

From 8ff0679e2390baf267520398955d4c7492424702 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Thu, 3 Jul 2014 13:50:25 +0800
Subject: [PATCH 04/24] add require

---
 js/sui.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/js/sui.js b/js/sui.js
index c700b2b5..fabcf17a 100644
--- a/js/sui.js
+++ b/js/sui.js
@@ -21,3 +21,4 @@ require('./checkbox')
 require('./autocomplete')
 require('./navtest')
 require('./intro')
+require('./upload')

From 1220cf433f7eb6419ab6c23f6ecfa461b51db42a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Tue, 8 Jul 2014 10:19:42 +0800
Subject: [PATCH 05/24] updat

---
 js/upload.js | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 79b030a1..d1123252 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -116,9 +116,17 @@
     }
   });
 
+  /*
+   * $.upload({
+   *  api: {string} 后端上传服务api地址
+   *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
+   *  data: {object}  除了上传的文件外需要额外传输的数据（经常后端需要）
+   *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
+   * })
+   */
   $.extend({
     upload: function(opt) {
-      var $fileinputs = opt.$fileinputs;
+      var $fileinputs = opt.$fileinputs || [];
       $.each($fileinputs, function(k, v){
         var type = $(v).prop('type');
         if ( type != 'file') {
@@ -144,7 +152,7 @@
             processData: false
           })
         }
-        $.ajax(opt.api, param).success(function(data) {
+        $.ajax(opt.api || '', param).success(function(data) {
           if (typeof opt.success == 'function') {
             opt.success.call(fileinput, data);
           }

From 3d6fe8d15553b3049a0657b70de3022abf7d89d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Tue, 8 Jul 2014 10:29:47 +0800
Subject: [PATCH 06/24] update coments

---
 js/upload.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/js/upload.js b/js/upload.js
index d1123252..0033bd2b 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -121,6 +121,8 @@
    *  api: {string} 后端上传服务api地址
    *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
    *  data: {object}  除了上传的文件外需要额外传输的数据（经常后端需要）
+   *  triggerType: {string} 触发上传的方式，可选值为有效的事件类型，如click,change,mouseup等，默认‘change’。必须结合triggerEle使用。如果不传全则默认file input change时上传文件。
+   *  triggerEle: {string|HTMLElement}  触发上传的元素，必须结合triggerType使用。如果不传全则默认file input change时上传文件。
    *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
    * })
    */

From 5b331555824119f13309793aee43524e6b955e39 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Tue, 8 Jul 2014 13:55:05 +0800
Subject: [PATCH 07/24] update

---
 js/upload.js | 32 +++++++++++++++++++-------------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 0033bd2b..263d6697 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -120,7 +120,7 @@
    * $.upload({
    *  api: {string} 后端上传服务api地址
    *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
-   *  data: {object}  除了上传的文件外需要额外传输的数据（经常后端需要）
+   *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
    *  triggerType: {string} 触发上传的方式，可选值为有效的事件类型，如click,change,mouseup等，默认‘change’。必须结合triggerEle使用。如果不传全则默认file input change时上传文件。
    *  triggerEle: {string|HTMLElement}  触发上传的元素，必须结合triggerType使用。如果不传全则默认file input change时上传文件。
    *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
@@ -136,30 +136,36 @@
         }
       })
 
-      $fileinputs.on('change', function(e) {
+
+      if (opt.triggerType && opt.triggerEle) {
+        $('body').on(opt.triggerType + 'upload', opt.triggerEle, function(e){
+        
+        })
+      }
+      $fileinputs.on('change.upload', function(e) {
         var fileinput = this
-          , data = opt.data
+        $.ajax(opt.api || '', param).success(function(data) {
+          if (typeof opt.success == 'function') {
+            opt.success.call(fileinput, data);
+          }
+        });
+      });
+      function getParam (fileinput, opt) {
+        var data = opt.data
           , param = {
             type: 'post',
             dataType: 'json',
             files: fileinput,
             upload: true
           };
-        if (typeof opt.data == 'function') {
-          data = opt.data.call(this);
-        }
+        (typeof opt.data == 'function') && (data = data())
         if (data) {
           $.extend(param, {
             data: data,
             processData: false
           })
-        }
-        $.ajax(opt.api || '', param).success(function(data) {
-          if (typeof opt.success == 'function') {
-            opt.success.call(fileinput, data);
-          }
-        });
-      });
+        }     
+      }
     }
   })
 

From c7f5e43749fb60aa794711a8e0efce15f5d579f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 9 Jul 2014 11:59:34 +0800
Subject: [PATCH 08/24] update

---
 js/upload.js | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 263d6697..ad77f4fe 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -135,22 +135,23 @@
           throw Error('upload——传入控件类型应为file，实际有type为' + type + '的控件!');
         }
       })
-
-
       if (opt.triggerType && opt.triggerEle) {
-        $('body').on(opt.triggerType + 'upload', opt.triggerEle, function(e){
-        
+         $(opt.triggerEle).on(opt.triggerType + '.upload', function(e){
+          var param = getParam($fileinputs);
+          //TODO  
         })
-      }
-      $fileinputs.on('change.upload', function(e) {
-        var fileinput = this
-        $.ajax(opt.api || '', param).success(function(data) {
-          if (typeof opt.success == 'function') {
-            opt.success.call(fileinput, data);
-          }
+      } else {
+        $fileinputs.on('change.upload', function(e) {
+          var fileinput = this
+            , param = getParam(fileinput);
+          $.ajax(opt.api || '', param).success(function(data) {
+            if (typeof opt.success == 'function') {
+              opt.success.call(fileinput, data);
+            }
+          });
         });
-      });
-      function getParam (fileinput, opt) {
+      }
+      function getParam (fileinput) {
         var data = opt.data
           , param = {
             type: 'post',

From 75fb7268b0542934c25f73c054f146822a69fc8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Fri, 11 Jul 2014 22:15:46 +0800
Subject: [PATCH 09/24] =?UTF-8?q?=E7=AE=80=E5=8C=96=E6=A8=A1=E5=9E=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 29 ++++++++---------------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index ad77f4fe..1c873c87 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -75,10 +75,6 @@
 
           // iframe被注入到DOM后触发第一个load事件，已准备提交文件
           iframe.one('load', function() {
-            // The second load event gets fired when the response to the form
-            // submission is received. The implementation detects whether the
-            // actual payload is embedded in a `<textarea>` element, and
-            // prepares the required conversions to be made in that case.
             // 第二个load在收到服务器响应表单提交后。
             iframe.one("load", function() {
               var doc = this.contentWindow ? this.contentWindow.document :
@@ -121,8 +117,6 @@
    *  api: {string} 后端上传服务api地址
    *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
    *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
-   *  triggerType: {string} 触发上传的方式，可选值为有效的事件类型，如click,change,mouseup等，默认‘change’。必须结合triggerEle使用。如果不传全则默认file input change时上传文件。
-   *  triggerEle: {string|HTMLElement}  触发上传的元素，必须结合triggerType使用。如果不传全则默认file input change时上传文件。
    *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
    * })
    */
@@ -135,22 +129,15 @@
           throw Error('upload——传入控件类型应为file，实际有type为' + type + '的控件!');
         }
       })
-      if (opt.triggerType && opt.triggerEle) {
-         $(opt.triggerEle).on(opt.triggerType + '.upload', function(e){
-          var param = getParam($fileinputs);
-          //TODO  
-        })
-      } else {
-        $fileinputs.on('change.upload', function(e) {
-          var fileinput = this
-            , param = getParam(fileinput);
-          $.ajax(opt.api || '', param).success(function(data) {
-            if (typeof opt.success == 'function') {
-              opt.success.call(fileinput, data);
-            }
-          });
+      $fileinputs.on('change.upload', function(e) {
+        var fileinput = this
+          , param = getParam(fileinput);
+        $.ajax(opt.api || '', param).success(function(data) {
+          if (typeof opt.success == 'function') {
+            opt.success.call(fileinput, data);
+          }
         });
-      }
+      });
       function getParam (fileinput) {
         var data = opt.data
           , param = {

From 478e1a42de9f33043975a459d8e41b071d270aca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sat, 12 Jul 2014 18:02:14 +0800
Subject: [PATCH 10/24] =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=A7=E5=B0=8F?=
 =?UTF-8?q?=E6=A0=A1=E9=AA=8C=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 57 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 40 insertions(+), 17 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 1c873c87..64e45f85 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -111,12 +111,37 @@
       };
     }
   });
+  //提取上传参数
+  function getParam (fileinput) {
+    var data = opt.data
+      , param = {
+        type: 'post',
+        dataType: 'json',
+        files: fileinput,
+        upload: true
+      };
+    (typeof opt.data == 'function') && (data = data())
+    if (data) {
+      $.extend(param, {
+        data: data,
+        processData: false
+      })
+    }     
+    return param;
+  }
+  // 文件大小限制
+  // max {numer} 单位KB,进制为1000（不是1024）
+  // min {numer} 单位KB,进制为1000（不是1024）
+  function sizeLimit (sl) {
+    
+  }
 
   /*
    * $.upload({
    *  api: {string} 后端上传服务api地址
    *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
    *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
+   *  sizeLimit: {number | object} 文件大小限制, 单位KB,进制为1000（不是1024）。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。
    *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
    * })
    */
@@ -131,29 +156,27 @@
       })
       $fileinputs.on('change.upload', function(e) {
         var fileinput = this
-          , param = getParam(fileinput);
+          , param = getParam(fileinput)
+          , sl = opt.sizeLimit,
+          , ret;
+        //文件大小限制
+        if (typeof sl == 'number') {
+          ret = checkSize (sl);
+        } else if (typeof sl == 'object') {
+          ret = checkSize (sl.max, sl.min);
+        }
+        //处理大小判断结果
+        !ret.isok && $.alert({
+          title: '上传文件不合法'
+          ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
+          ,timeout: 2000
+        }); 
         $.ajax(opt.api || '', param).success(function(data) {
           if (typeof opt.success == 'function') {
             opt.success.call(fileinput, data);
           }
         });
       });
-      function getParam (fileinput) {
-        var data = opt.data
-          , param = {
-            type: 'post',
-            dataType: 'json',
-            files: fileinput,
-            upload: true
-          };
-        (typeof opt.data == 'function') && (data = data())
-        if (data) {
-          $.extend(param, {
-            data: data,
-            processData: false
-          })
-        }     
-      }
     }
   })
 

From 8330c5b16033336c7c488062d43733197fc5a016 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sat, 12 Jul 2014 18:02:38 +0800
Subject: [PATCH 11/24] =?UTF-8?q?file=20input=20=E5=8F=98=E4=B8=BA?=
 =?UTF-8?q?=E7=A9=BAvalue=E6=97=B6=E4=B8=8D=E6=89=A7=E8=A1=8C=E9=80=BB?=
 =?UTF-8?q?=E8=BE=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/js/upload.js b/js/upload.js
index 64e45f85..bab8c3d6 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -155,6 +155,7 @@
         }
       })
       $fileinputs.on('change.upload', function(e) {
+        if (!$(this).val()) return;
         var fileinput = this
           , param = getParam(fileinput)
           , sl = opt.sizeLimit,

From 65408fa32e0d21301ec40bbbebb9dbcaab4c88c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sat, 12 Jul 2014 18:12:21 +0800
Subject: [PATCH 12/24] =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=A7=E5=B0=8F?=
 =?UTF-8?q?=E9=9D=9E=E6=B3=95=E6=8F=90=E7=A4=BA=E6=A1=86=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index bab8c3d6..c301f8e8 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -167,11 +167,14 @@
           ret = checkSize (sl.max, sl.min);
         }
         //处理大小判断结果
-        !ret.isok && $.alert({
-          title: '上传文件不合法'
-          ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
-          ,timeout: 2000
-        }); 
+        if (!ret.isok) {
+          $.alert({
+            title: '上传文件不合法'
+            ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
+            ,timeout: 2000
+            ,bgColor: '#fff'
+          }) 
+        }
         $.ajax(opt.api || '', param).success(function(data) {
           if (typeof opt.success == 'function') {
             opt.success.call(fileinput, data);

From 2d24957c7c7bdc4c09b56db4fdca4ddba5dd0deb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sat, 12 Jul 2014 18:19:18 +0800
Subject: [PATCH 13/24] =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=A7=E5=B0=8F?=
 =?UTF-8?q?=E9=99=90=E5=88=B6=E9=80=BB=E8=BE=91=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index c301f8e8..51df73d8 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -132,8 +132,8 @@
   // 文件大小限制
   // max {numer} 单位KB,进制为1000（不是1024）
   // min {numer} 单位KB,进制为1000（不是1024）
-  function sizeLimit (sl) {
-    
+  function checkSize (max, min) {
+   
   }
 
   /*
@@ -161,11 +161,7 @@
           , sl = opt.sizeLimit,
           , ret;
         //文件大小限制
-        if (typeof sl == 'number') {
-          ret = checkSize (sl);
-        } else if (typeof sl == 'object') {
-          ret = checkSize (sl.max, sl.min);
-        }
+        ret = checkSize.apply(fileinput, typeof sl == 'number' ? [sl] : (typeof sl == 'object' ? [sl.max, sl.min] : []));
         //处理大小判断结果
         if (!ret.isok) {
           $.alert({
@@ -173,8 +169,10 @@
             ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
             ,timeout: 2000
             ,bgColor: '#fff'
-          }) 
+          }); 
+          return;
         }
+        //上传
         $.ajax(opt.api || '', param).success(function(data) {
           if (typeof opt.success == 'function') {
             opt.success.call(fileinput, data);

From 318e6ce35c8134e8fe2f94bd9f9eccd327943cc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sat, 12 Jul 2014 22:03:45 +0800
Subject: [PATCH 14/24] =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=A7=E5=B0=8F?=
 =?UTF-8?q?=E6=A3=80=E6=B5=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 js/upload.js | 46 ++++++++++++++++++++++++++++++----------------
 1 file changed, 30 insertions(+), 16 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 51df73d8..e41516d3 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -130,10 +130,21 @@
     return param;
   }
   // 文件大小限制
-  // max {numer} 单位KB,进制为1000（不是1024）
-  // min {numer} 单位KB,进制为1000（不是1024）
+  // max {numer} 单位KB
+  // min {numer} 单位KB
+  // this为file input
   function checkSize (max, min) {
-   
+    var size = this.files[0].size
+      ,ret = {isok:true, errMsg: ''};
+    if (typeof max == 'number' && size > max) {
+      ret.isok = false; 
+      ret.errMsg = '文件大小请不要超过' + $;
+    }
+    if (typeof min == 'number' && size < min) {
+      ret.isok = false; 
+      ret.errMsg = '文件大小请不要小于' + $;
+    }
+    return ret;
   }
 
   /*
@@ -141,7 +152,7 @@
    *  api: {string} 后端上传服务api地址
    *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
    *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
-   *  sizeLimit: {number | object} 文件大小限制, 单位KB,进制为1000（不是1024）。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。
+   *  sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
    *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
    * })
    */
@@ -158,19 +169,22 @@
         if (!$(this).val()) return;
         var fileinput = this
           , param = getParam(fileinput)
-          , sl = opt.sizeLimit,
+          , sl = opt.sizeLimit
           , ret;
-        //文件大小限制
-        ret = checkSize.apply(fileinput, typeof sl == 'number' ? [sl] : (typeof sl == 'object' ? [sl.max, sl.min] : []));
-        //处理大小判断结果
-        if (!ret.isok) {
-          $.alert({
-            title: '上传文件不合法'
-            ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
-            ,timeout: 2000
-            ,bgColor: '#fff'
-          }); 
-          return;
+        //有大小限制需求且是有files接口的浏览器环境
+        if (sl && fileinput.files) {
+          //文件大小限制
+          ret = checkSize.apply(fileinput, typeof sl == 'number' ? [sl * 1024] : (typeof sl == 'object' ? [sl.max * 1024, sl.min * 1024] : []));
+          //处理大小判断结果
+          if (!ret.isok) {
+            $.alert({
+              title: '上传文件不合法'
+              ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
+              ,timeout: 2000
+              ,bgColor: '#fff'
+            }); 
+            return;
+          }
         }
         //上传
         $.ajax(opt.api || '', param).success(function(data) {

From 66bef093dcf0867c978fa936160abb6be4fd33f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 16 Jul 2014 11:14:01 +0800
Subject: [PATCH 15/24] import filesize

---
 js/upload.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index e41516d3..48e541f2 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -138,11 +138,11 @@
       ,ret = {isok:true, errMsg: ''};
     if (typeof max == 'number' && size > max) {
       ret.isok = false; 
-      ret.errMsg = '文件大小请不要超过' + $;
+      ret.errMsg = '文件大小请不要超过' + $.filesize(size);
     }
     if (typeof min == 'number' && size < min) {
       ret.isok = false; 
-      ret.errMsg = '文件大小请不要小于' + $;
+      ret.errMsg = '文件大小请不要小于' + $.filesize(size);
     }
     return ret;
   }

From a35893b15a330ce152f8255c148a3ae771f0c71d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Thu, 17 Jul 2014 16:15:21 +0800
Subject: [PATCH 16/24] update

---
 js/upload.js | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 48e541f2..4eda7b12 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -1,4 +1,13 @@
 /* jshint ignore:start */
+/*
+ * $.upload({
+ *  api: {string} 后端上传服务api地址
+ *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
+ *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
+ *  sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
+ *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
+ * })
+ */
 (function($) {
   // 注册一个ajax prefilter,创建新的type类型upload，检测ajax方法调用的入参有没有upload
   $.ajaxPrefilter(function(options, origOptions, jqXHR) {
@@ -147,15 +156,6 @@
     return ret;
   }
 
-  /*
-   * $.upload({
-   *  api: {string} 后端上传服务api地址
-   *  $fileinputs: {ArrayLike}  元素集合，必须全为file input
-   *  data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
-   *  sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
-   *  success: {function}  上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）
-   * })
-   */
   $.extend({
     upload: function(opt) {
       var $fileinputs = opt.$fileinputs || [];

From 5a1c7eb6d4cdcb773bd33809ad27538efc31e5b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sun, 27 Jul 2014 17:33:53 +0800
Subject: [PATCH 17/24] update upload

---
 js/upload.js | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index 4eda7b12..90c38e6e 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -121,21 +121,20 @@
     }
   });
   //提取上传参数
-  function getParam (fileinput) {
-    var data = opt.data
-      , param = {
+  function getParam (fileinput, data) {
+    var param = {
         type: 'post',
         dataType: 'json',
         files: fileinput,
         upload: true
       };
-    (typeof opt.data == 'function') && (data = data())
+    (typeof data == 'function') && (data = data())
     if (data) {
       $.extend(param, {
         data: data,
         processData: false
       })
-    }     
+    }
     return param;
   }
   // 文件大小限制
@@ -146,11 +145,11 @@
     var size = this.files[0].size
       ,ret = {isok:true, errMsg: ''};
     if (typeof max == 'number' && size > max) {
-      ret.isok = false; 
+      ret.isok = false;
       ret.errMsg = '文件大小请不要超过' + $.filesize(size);
     }
     if (typeof min == 'number' && size < min) {
-      ret.isok = false; 
+      ret.isok = false;
       ret.errMsg = '文件大小请不要小于' + $.filesize(size);
     }
     return ret;
@@ -168,7 +167,7 @@
       $fileinputs.on('change.upload', function(e) {
         if (!$(this).val()) return;
         var fileinput = this
-          , param = getParam(fileinput)
+          , param = getParam(fileinput, opt.data)
           , sl = opt.sizeLimit
           , ret;
         //有大小限制需求且是有files接口的浏览器环境
@@ -182,7 +181,7 @@
               ,body: '<div class="sui-msg msg-large msg-block msg-error"><div class="msg-con">' + ret.errMsg + '</div><s class="msg-icon"></s></div>'
               ,timeout: 2000
               ,bgColor: '#fff'
-            }); 
+            });
             return;
           }
         }

From aa15570aa0c0bdfc841750d930aeae6c6b5497fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 13 Aug 2014 17:48:27 +0800
Subject: [PATCH 18/24] update

---
 js/upload.js | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/js/upload.js b/js/upload.js
index 90c38e6e..79dcf7f9 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -195,5 +195,20 @@
     }
   })
 
+  /*
+  //事件委托，使组件可以无js初始化的简单调用
+  $(document).on('change.upload', '[data-toggle="upload"]', function(e){
+    var $this = $(this)
+      , extraData = $.parseJSON($this.data('param'))
+      , api = $this.data('api')
+    $.upload({
+      $fileinputs: $this 
+      ,api: api
+      ,data: extraData
+      ,success: 秋风萧瑟，改日再续
+    })
+  })
+  */
+
 })(jQuery);
 /* jshint ignore:end */

From ca918ca99db36f111bed66442366b8fde2012435 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 13 Aug 2014 19:13:59 +0800
Subject: [PATCH 19/24] update upload docs

---
 docs/templates/sidenav.jade |  1 +
 docs/templates/upload.jade  | 19 ++++++++++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/templates/sidenav.jade b/docs/templates/sidenav.jade
index 63938dbc..1b4bc505 100644
--- a/docs/templates/sidenav.jade
+++ b/docs/templates/sidenav.jade
@@ -43,6 +43,7 @@ ul.sui-nav.nav-stacked.docs-sidenav.docs-nav
   - items[4].children.push({name: 'tooltip', title:'tooltip', url:'tooltip.html'})
 
   - items[5].children.push({name: 'filesize', title:'filesize', url:'filesize.html'})
+  - items[5].children.push({name: 'upload', title:'upload', url:'upload.html'})
 
   - items[6].children.push({name: 'Loading', title:'Loading', url:'loading.html'})
   - items[6].children.push({name: 'progress', title:'进度条', url:'progress.html'})
diff --git a/docs/templates/upload.jade b/docs/templates/upload.jade
index 7cd4e3e6..59712ce9 100644
--- a/docs/templates/upload.jade
+++ b/docs/templates/upload.jade
@@ -1,13 +1,30 @@
 extends base
 
 block title
-  title Tag 
+  title Upload 
 
 block sidebar
   +sidebar('upload')
 
 block content
 
+  h2 upload: 一个超轻量级的上传逻辑组件。
+
   h2.sui-page-header 开发者文档
 
+  p 组件只提供逻辑，不提供UI元素。
+
+  ul.sui-nav.nav-tabs.nav-large
+    li.active
+      a(href='#doc1', data-toggle='tab') 文档
 
+  div.tab-content
+    div#doc1
+      pre.prettyprint.
+        $.upload({
+          api: {string} 后端上传服务api地址
+          $fileinputs: {ArrayLike}  元素集合，必须全为file input
+          data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
+          sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
+          success: {function} function(json){} 上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）。形参json是各后端返回的json数据
+        })

From 6e0822c97da667d5cd01a606b5f5b816e06a5487 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 13 Aug 2014 19:27:48 +0800
Subject: [PATCH 20/24] update

---
 docs/templates/upload.jade | 2 +-
 js/upload.js               | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/templates/upload.jade b/docs/templates/upload.jade
index 59712ce9..e22735e9 100644
--- a/docs/templates/upload.jade
+++ b/docs/templates/upload.jade
@@ -23,7 +23,7 @@ block content
       pre.prettyprint.
         $.upload({
           api: {string} 后端上传服务api地址
-          $fileinputs: {ArrayLike}  元素集合，必须全为file input
+          $fileinputs: {jQuery Object ArrayLike}  jQuery对象元素集合，必须全为file input
           data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
           sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
           success: {function} function(json){} 上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）。形参json是各后端返回的json数据
diff --git a/js/upload.js b/js/upload.js
index 79dcf7f9..f3b04f01 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -161,7 +161,7 @@
       $.each($fileinputs, function(k, v){
         var type = $(v).prop('type');
         if ( type != 'file') {
-          throw Error('upload——传入控件类型应为file，实际有type为' + type + '的控件!');
+          throw Error('传入控件类型应为file，实际有type为' + type + '的控件!');
         }
       })
       $fileinputs.on('change.upload', function(e) {

From be92b6eea4e7cc604b7369cf682539a85af6b181 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Wed, 13 Aug 2014 19:41:03 +0800
Subject: [PATCH 21/24] update docs

---
 docs/templates/upload.jade | 42 ++++++++++++++++++++++++++++++--------
 1 file changed, 33 insertions(+), 9 deletions(-)

diff --git a/docs/templates/upload.jade b/docs/templates/upload.jade
index e22735e9..1bdb36a3 100644
--- a/docs/templates/upload.jade
+++ b/docs/templates/upload.jade
@@ -17,14 +17,38 @@ block content
   ul.sui-nav.nav-tabs.nav-large
     li.active
       a(href='#doc1', data-toggle='tab') 文档
+    li
+      a(href='#demo1', data-toggle='tab') 示例
 
   div.tab-content
-    div#doc1
-      pre.prettyprint.
-        $.upload({
-          api: {string} 后端上传服务api地址
-          $fileinputs: {jQuery Object ArrayLike}  jQuery对象元素集合，必须全为file input
-          data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
-          sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
-          success: {function} function(json){} 上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）。形参json是各后端返回的json数据
-        })
+    div.tab-pane.active#doc1
+      div#doc1
+        p 这是一个轻逻辑的组件，对后端架构、规则几乎没有限制，可以根据不同用户的后端平台、约定选择数据交互规范。
+        pre.prettyprint.
+          $.upload({
+            api: {string} 后端上传服务api地址
+            $fileinputs: {jQuery Object ArrayLike}  jQuery对象元素集合，必须全为file input
+            data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
+            sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
+            success: {function} function(json){} 上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）。形参json是各后端返回的json数据
+          })
+    div.tab-pane#demo1
+      div#ex1
+        p 举个栗子
+        pre.prettyprint.
+          $.upload({
+            $fileinputs: $('#onefile').find('[type=file]')
+            ,api: 'http://xx.com/xx.do'
+            ,data: function(){
+              //this指向对应file input
+              var level = $(this).data('level');
+              return $.extend({}, {"level": level});
+            }
+            ,success: function(data) {
+              if (data.flag) {
+                //doSomethingSuccess...
+              } else {
+                //doSomethingFailure...
+              }
+            }
+          });

From ce37b467f1f286c7f9056bda78e787538f688610 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Sun, 28 Sep 2014 11:16:40 +0800
Subject: [PATCH 22/24] add error method

---
 js/upload.js | 19 +++++--------------
 1 file changed, 5 insertions(+), 14 deletions(-)

diff --git a/js/upload.js b/js/upload.js
index f3b04f01..0296a61e 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -190,25 +190,16 @@
           if (typeof opt.success == 'function') {
             opt.success.call(fileinput, data);
           }
+        }).error(function(){
+          $(fileinput).val('');
+          if (typeof opt.error == 'function') {
+            opt.error.call(fileinput);
+          }
         });
       });
     }
   })
 
-  /*
-  //事件委托，使组件可以无js初始化的简单调用
-  $(document).on('change.upload', '[data-toggle="upload"]', function(e){
-    var $this = $(this)
-      , extraData = $.parseJSON($this.data('param'))
-      , api = $this.data('api')
-    $.upload({
-      $fileinputs: $this 
-      ,api: api
-      ,data: extraData
-      ,success: 秋风萧瑟，改日再续
-    })
-  })
-  */
 
 })(jQuery);
 /* jshint ignore:end */

From d7b2db67371652e5459f4141a292c1d236f28ccb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Mon, 13 Oct 2014 15:18:16 +0800
Subject: [PATCH 23/24] update docs

---
 docs/templates/sidenav.jade | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/templates/sidenav.jade b/docs/templates/sidenav.jade
index 08a18e9c..c2c139e2 100644
--- a/docs/templates/sidenav.jade
+++ b/docs/templates/sidenav.jade
@@ -44,7 +44,7 @@ ul.sui-nav.nav-stacked.docs-sidenav.docs-nav
   - items[4].children.push({name: 'tooltip', title:'tooltip', url:'tooltip.html'})
 
   - items[5].children.push({name: 'filesize', title:'filesize', url:'filesize.html'})
-  - items[5].children.push({name: 'upload', title:'upload', url:'upload.html'})
+  - items[5].children.push({name: 'upload', title:'上传图片', url:'upload.html'})
   - items[5].children.push({name: 'template', title:'字符串模板', url:'template.html'})
 
   - items[6].children.push({name: 'Loading', title:'Loading', url:'loading.html'})

From 2eaa2b20148ce0b2277d17a589dadf66f1230e9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8A=E8=BE=B9?= <zangtao.zt@alibaba-inc.com>
Date: Mon, 13 Oct 2014 17:06:03 +0800
Subject: [PATCH 24/24] update docs

---
 docs/templates/upload.jade | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/templates/upload.jade b/docs/templates/upload.jade
index 1bdb36a3..03906958 100644
--- a/docs/templates/upload.jade
+++ b/docs/templates/upload.jade
@@ -9,6 +9,9 @@ block sidebar
 block content
 
   h2 upload: 一个超轻量级的上传逻辑组件。
+  script(src="http://localhost/git/Jcrop/js/jquery.Jcrop.js")
+  link(href="http://localhost/git/Jcrop/css/jquery.Jcrop.css", rel="stylesheet")
+
 
   h2.sui-page-header 开发者文档
 
@@ -31,6 +34,7 @@ block content
             data: {object | function}  除了上传的文件外需要额外传输的数据（经常后端需要）。如果传入匿名函数则取返回值为data
             sizeLimit: {number | object} 文件大小限制, 单位KB。传入一个数字则为最大size；传入对象则是{min:1000,max:3000}形式，max必须比min大。该参数只在IE9以上及现代浏览器、千牛有效。且服务器端校验仍是必须的。
             success: {function} function(json){} 上传网络层成功后的回调（注意业务逻辑可能使这次上传失败无效）。形参json是各后端返回的json数据
+            error: {function} 上传网络失败后的回调
           })
     div.tab-pane#demo1
       div#ex1