DIV CSS 佈局教程網

用 jQuery WebUploader 實作多圖上傳與縮圖預覽
編輯:JQuery入門技巧     

最近專案需要圖片上傳功能,選用了百度的 WebUploader。它是一個以 HTML5 為主、Flash 為輔的現代化上傳元件,在現代瀏覽器中能發揮 HTML5 的優勢,同時保留 Flash 執行環境以相容 IE6+、iOS 6+、Android 4+;兩套執行環境提供一致的呼叫方式,並以大檔分片併發提升傳輸效率。可到 https://fex.baidu.com/webuploader/download.html 下載。

實作:多圖上傳 + 縮圖 + 可移除

 // 初始化 Web Uploader —— 上傳圖片
var uploader = WebUploader.create({
    auto: true,                              // 選完檔案後自動上傳
    server: '/common/uploadFile?imageZip=1', // 接收端;縮圖需後端配合
    pick: '#sendimg',
    fileNumLimit: 5,
    accept: {
        title: 'Images',
        extensions: 'gif,jpg,jpeg,bmp,png',
        mimeTypes: 'image/*'
    }
});

// 有檔案加入時,建立列表項與縮圖
uploader.on('fileQueued', function(file){
    var $li = $('<div style="float:right" id="' + file.id + '" class="delimg">'
        + '<img class="addimg"><div class="closeimg">×</div></div>'),
        $img = $li.find('img');

    $("#piccon").append($li);

    uploader.makeThumb(file, function(error, src){
        if (error) {
            $img.replaceWith('<span>不能預覽</span>');
            return;
        }
        $img.attr('src', src);
    }, 100, 100);

    // 點擊項目即可移除
    $li.on('click', function(){ $(this).remove(); });
});

// 上傳進度
uploader.on('uploadProgress', function(file, percentage){
    var $li = $('#' + file.id), $percent = $li.find('.progress span');
    if (!$percent.length) {
        $percent = $('<p class="progress"><span></span></p>').appendTo($li).find('span');
    }
    $percent.css('width', percentage * 100 + '%');
});

// 上傳成功
uploader.on('uploadSuccess', function(file, response){
    var imgurl = response.fileName;   // 後端回傳的檔名/路徑
    $('#' + file.id).addClass('upload-state-done');
});

// 上傳失敗
uploader.on('uploadError', function(file){
    var $li = $('#' + file.id), $error = $li.find('div.error');
    if (!$error.length) {
        $error = $('<div class="error"></div>').appendTo($li);
    }
    $error.text('上傳失敗');
});

// 上傳結束,移除進度條
uploader.on('uploadComplete', function(file){
    $('#' + file.id).find('.progress').remove();
}); 

幾個實作上的考量

fileNumLimit 的作用。它限制的是「佇列中可同時存在的檔案數」。若要限制總選擇數量,可以搭配 fileSizeLimit(總容量)與 fileSingleSizeLimit(單檔容量)一起設定,三者分工不同。

移除檔案要記得同步後端。範例中的 $li.on('click') 只移除了畫面上的項目。若檔案已經上傳成功,僅移除 DOM 會在伺服器留下孤兒檔案。正確做法是在移除前先呼叫 uploader.removeFile(uploader.getFile(id)),並向後端發請求刪除實體檔案。

回傳值要統一。範例從 response.fileName 取用上傳後的檔名,這意味著前後端必須先約定好回應結構。建議固定成 JSON,例如 {"code":0,"fileName":"a.jpg","url":"/upload/a.jpg"},並在 uploadSuccess 中先檢查 code 再更新畫面。

需要手動上傳時。把 auto 設為 false,改由「開始上傳」按鈕呼叫 uploader.upload(),就能讓使用者先挑選、確認後再一次送出,這個模式在後台管理的表單中特別常見。

小結

WebUploader 的設計哲學是「只管傳輸,不管 UI」,所以上面這段程式碼裡絕大多數都是你自己決定的呈現方式。這種自由度是它的優點,但也代表狀態同步與資源清理要自己負責。把 fileQueued、uploadProgress、uploadSuccess、uploadError、uploadComplete 這五個事件掌握好,客製化就沒有太大的障礙。

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