最近專案需要圖片上傳功能,選用了百度的 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 這五個事件掌握好,客製化就沒有太大的障礙。