拖曳上傳其實沒有想像中難,騰訊微博當年也做過類似的功能。以下把整個實作思路與關鍵 API 整理清楚。
要完成拖曳上傳,瀏覽器必須具備兩項能力:
1. 支援 drop 事件,能在響應拖曳時取得 file 物件;
2. XMLHttpRequest 物件擁有 sendAsBinary 方法,用於發送二進位數據。
在當時,這兩個條件僅 Firefox 能同時滿足。Chrome 第一項達標,第二項則可借助 google.gears 模擬。因此,能實作拖曳上傳的瀏覽器為 Firefox 3.6+ 與 Chrome 7+。
1. 綁定 drop 事件;
2. 取得 file 物件;
3. 取得物件的二進位數據;
4. 模擬發送 POST 請求。
由於 XMLHttpRequest 與 google.gears 差異頗大,我將上述第 2、3、4 步驟封裝成 UpLoadFileXHR,只要實例化它就能完成拖曳上傳。
步驟一:引入檔案
<script type="text/javascript" src="UpLoadFileXHR.js"></script>
步驟二:實例化並綁定事件、設定參數
/**
* var upLoad = new UpLoadFileXHR({url:'/cgi-bin/upload_img_fdfs', name:'Filedata'});
* url : 上傳數據路徑
* name : 後台讀取數據的 name
* XHR : google.gears or new XMLHttpRequest()
* format : 上傳格式正則表達式
*
* Methods
* .onerror function 出現錯誤
* .onloadstart function 傳送開始 Parameter Event物件
* .onprogress function 傳送進度 Parameter Event物件
* .onreadystatechange function 狀態 Parameter this.XHR
*/
var upLoad = new UpLoadFileXHR({url:'/cgi-bin/upload_img_fdfs', name:'Filedata'});
upLoad.format = /jpg|gif|jpeg|png/; // 設定上傳格式
upLoad.onformaterror = function(){
alert('上傳格式錯誤,僅支持[jpg|gif|jpeg|png] 格式!');
}
upLoad.onreadystatechange = function(){
if(upLoad.XHR.readyState == 4){
log(upLoad.XHR.responseText);
}
}
upLoad.onloadstart = function(f){
// 開始上傳
}
upLoad.onprogress = function(e){
/*
* e.loaded 已經上傳的數據大小
* e.total 總大小
* Math.round((e.loaded * 100) / e.total) 上傳百分比
*/
log('已經上傳了 ' + Math.round((e.loaded * 100) / e.total) + '%')
}
步驟三:綁定 drop 事件
/*
* 我們只需要 ondrop 事件
* ondragenter 和 ondragover 直接綁定 stopPrevent 取消默認動作
* ondrop 綁定 start,注意這裡一定要用 call 把 this 指向實例化物件
*/
elem.ondragenter = upLoad.stopPrevent;
elem.ondragover = upLoad.stopPrevent;
elem.ondrop = function(e){ upLoad.stopPrevent(e); upLoad.start.call(upLoad, e); };
建構子:new UpLoadFileXHR(Object)
參數:
url(string,必填)上傳地址;
name(string,必填)後台取得數據的 name。
屬性:
format(RegExp)過濾檔案類型,如 /jpg|pen|jpeg|gif/,不設定則所有檔案通過;
debug(Boolean)是否開啟除錯,預設 false。
自動填充屬性:
XHR(object)實例化後依瀏覽器自動填充,保存當前上傳所用的 xhr 物件;
support(object)當前使用的傳輸方式,形如 {googleGears:Boolean, fileReader:Boolean}。
方法:
start 綁定到 drop 事件,接收一個事件參數,請將 this 指向調用它的物件;
stopPrevent 取消事件冒泡與默認動作並 return false;
checkFile 檢查 file 屬性(格式、大小等),回傳 Boolean。
事件:
onerror 出錯(參數 e);onformaterror 格式不正確(參數 file);onloadstart 開始上傳;onprogress 上傳進度;onreadystatechange 上傳狀態。