異步上傳文件是為了更好的用戶體驗,是每個前端必須掌握的技能。這裡我提出三點有關異步文件上傳的方式。
使用第三方控件,如Flash,ActiveX等浏覽器插件上傳。
使用隱藏的iframe模擬異步上傳。
使用XMLHttpRequest2來實現異步上傳。
第一種使用浏覽器插件上傳,需要一定的底層編碼功底,在這裡我就不講了,以免誤人子弟,提出這點大家可以自行百度。
第二種使用隱藏的iframe模擬異步上傳。為什麼在這裡說的是模擬呢?因為我們其實是將返回結果放在了一個隱藏的iframe中,所以才沒有使當前頁面跳轉,感覺就像是異步操作一樣。
先貼出代碼:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-"> <title>隱藏的iframe上傳文件</title> <script type="text/javascript" src="jquery路徑..."></script> </head> <body> <iframe name="frm" style="display:none"></iframe> <form action="/upload" enctype="multipart/form-data" method="post" target="frm" onsubmit="loading(true);"> <p id="upfile">附件: <input type="file" name="myfile" style="display: inline"></p> <p id="upbtn"><input style="padding-left:px;padding-right: px;" type="submit" value="異步上傳"> <span id="uptxt" style="display: none">正在上傳...</span></p> </form> <div id="flist" style="border:px dotted darkgray;"></div> <script> // 上傳完成後的回調 function uploadFinished(fileName) { addToFlist(fileName); loading(false); } function addToFlist(fname) { var temp = ["<p id='" + fname + "'>", fname, "<button onclick='delFile(\"" + fname + "\");'>刪除</button>", "</p>" ]; $("#flist").append(temp.join("")); } function loading(showloading) { if (showloading) { $("#uptxt").show(); } else { $("#uptxt").hide(); } } </script> </body> </html>
這種技術有兩個關鍵的地方:
1.form會指定target,提交的結果定向返回到隱藏的ifram中。(即form的target與iframe的name屬性一致)。
2.提交完成後,iframe中頁面與主頁面通信,通知上傳結果及服務端文件信息
如何與主頁面通信呢?
我們用nodejs在接收完了文件後返回了一個window.parent.主頁面定義的方法,執行後可以得知文件上傳完成。代碼很簡單:
router.post('/upload', multipartMiddleware, function(req, res) { var fpath = req.files.myfile.path; var fname = fpath.substr(fpath.lastIndexOf('\\') + ); setTimeout(function() { var ret = ["<script>", "window.parent.uploadFinished('" + fname + "');", "</script>"]; res.send(ret.join("")); }, ); });
執行後可以打開開發人員選項,你會發現隱藏iframe中返回了服務器的一些數據。
第三種使用XMLHttpRequest2來進行真正的異步上傳。
還是先貼出代碼:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-"> <title>xhr level 異步上傳</title> <script type="text/javascript" src="jquery路徑..."></script> </head> <body> <div> <p id="upfile">附件: <input type="file" id="myfile" style="display: inline"></p> <p id="upbtn"> <input style="padding-left:px;padding-right: px;" type="button" value="異步上傳" onclick="upload();"> <span id="uptxt" style="display: none">正在上傳...</span> <span id="upprog"></span> <button id="stopbtn" style="display:none;">停止上傳</button> </p> </div> <div id="flist" style="border:px dotted darkgray;"></div> <script> function upload() { // .准備FormData var fd = new FormData(); fd.append("myfile", $("#myfile")[].files[]); // 創建xhr對象 var xhr = new XMLHttpRequest(); // 監聽狀態,實時響應 // xhr 和 xhr.upload 都有progress事件,xhr.progress是下載進度,xhr.upload.progress是上傳進度 xhr.upload.onprogress = function(event) { if (event.lengthComputable) { var percent = Math.round(event.loaded * / event.total); console.log('%d%', percent); $("#upprog").text(percent); } }; // 傳輸開始事件 xhr.onloadstart = function(event) { console.log('load start'); $("#upprog").text('開始上傳'); $("#stopbtn").one('click', function() { xhr.abort(); $(this).hide(); }); loading(true); }; // ajax過程成功完成事件 xhr.onload = function(event) { console.log('load success'); $("#upprog").text('上傳成功'); console.log(xhr.responseText); var ret = JSON.parse(xhr.responseText); addToFlist(ret.fname); }; // ajax過程發生錯誤事件 xhr.onerror = function(event) { console.log('error'); $("#upprog").text('發生錯誤'); }; // ajax被取消 xhr.onabort = function(event) { console.log('abort'); $("#upprog").text('操作被取消'); }; // loadend傳輸結束,不管成功失敗都會被觸發 xhr.onloadend = function (event) { console.log('load end'); loading(false); }; // 發起ajax請求傳送數據 xhr.open('POST', '/upload', true); xhr.send(fd); } function addToFlist(fname) { var temp = ["<p id='" + fname + "'>", fname, "<button onclick='delFile(\"" + fname + "\");'>刪除</button>", "</p>" ]; $("#flist").append(temp.join("")); } function delFile(fname) { console.log('to delete file: ' + fname); // TODO: 請實現 } function loading(showloading) { if (showloading) { $("#uptxt").show(); $("#stopbtn").show(); } else { $("#uptxt").hide(); $("#stopbtn").hide(); } } </script> </body> </html>
代碼有點多,但是通俗易懂。使用過AJAX的人都知道,XHR對象提供了一個onreadystatechange的回調方法來監聽整個請求/響應過程。在XMLHttpRequest2級規范中又多了幾個進度事件。有以下6個事件:
1.loadstart: 在接收到響應數據的第一個字節時觸發。
2.progress: 在接收響應期間持續不斷地觸發。
3.error: 在請求發生錯誤時觸發。
4.abort: 在因為調用abort()方法而終止連接時觸發。
5.load: 在接收到完整的響應數據時觸發。
6.loadend: 在通信完成或者觸發error,abort,load事件後觸發。
這次我們可以解讀代碼:當傳輸事件開始後,我們便在停止傳送按鈕上添加點擊事件,內置了abort方法可以停止傳送。若不點則會正常上傳直到傳送完畢為止。其後台代碼類似第二種方法。
三種方法各有優劣,做個簡單的小結吧。
第三方控件交互性和可控性好,因為接近底層,其性能也是很優秀的。但是由於編寫難度大通常需要自己安裝插件,有時可能需要自己進行編寫。
隱藏的iframe方法我個人覺得是非常有思想的一個方法,iframe可以幫我們做很多事。這種方式具有廣泛的浏覽器兼容性而且不需要安裝插件。但是它交互性差,上傳過程不可控,而且性能也是很一般的。
XHR2級的純ajax上傳,它必須要版本比較高一點的浏覽器(ie9+)。但是它交互性特別好,可以看到上傳進度並且是可控的。
開發可按需求來采用不同方法。個人覺得這些文件上傳,特別是第二種提供的是一種思想,充分的利用了某些html標簽的特性,可能是我們開發人員需要多思考的地方。