DIV CSS 佈局教程網

HTML5 附件拖曳上傳 drop 與 google.gears 實作解析
編輯:關於JavaScript     

拖曳上傳其實沒有想像中難,騰訊微博當年也做過類似的功能。以下把整個實作思路與關鍵 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); };

UpLoadFileXHR 介面說明

建構子: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 上傳狀態。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved