WebUploader 是由百度 WebFE(FEX)團隊開發的文件上傳組件,以 HTML5 為主、Flash 為輔。在現代瀏覽器中它能充分發揮 HTML5 的優勢,同時通過 Flash 運行時兼容老 IE,支援 IE6+、iOS 6+、Android 4+。兩套運行時共用同一套調用方式,可自由切換。它採用大文件分片並發上傳,對大文件場景的提升非常明顯。
整體能力比 ajaxfileupload 這類老插件強不少,可以直接從官網下載。
項目裡目前只用到圖片批量上傳,官方示例已經寫得很細,下面說說把示例遷移到自己項目時需要改哪幾處。
// 實例化
uploader = WebUploader.create({
// 選擇文件的按鈕
pick: {
id: '#filePicker',
label: '點擊選擇圖片'
},
// 附帶的表單參數
formData: { uid: 123 },
// 拖拽區域
dnd: '#dndArea',
// 粘貼上傳的容器
paste: '#uploader',
// Flash 運行時路徑
swf: '../../dist/Uploader.swf',
// 是否分片上傳
chunked: false,
chunkSize: 512 * 1024,
// 後台上傳接口
server: '../../server/fileupload.php',
// runtimeOrder: 'flash',
// 只允許上傳圖片
accept: {
title: 'Images',
extensions: 'gif,jpg,jpeg,bmp,png',
mimeTypes: 'image/*'
},
// 禁掉全局的拖拽功能,
// 否則把圖片拖進頁面時瀏覽器會直接打開該圖片
disableGlobalDnd: true,
// 最多上傳 300 個文件
fileNumLimit: 300,
// 總大小不超過 200M
fileSizeLimit: 200 * 1024 * 1024,
// 單個文件不超過 50M
fileSingleSizeLimit: 50 * 1024 * 1024
});
1. server 改成自己的後台處理地址
後端接收方式很直接,以 ASP.NET 為例:
HttpFileCollection files = System.Web.HttpContext.Current.Request.Files;
分片上傳時後端需要按 index 拼接,這部分邏輯官方示例裡有完整的 PHP 實現可以參考。
2. 按需關閉自動壓縮
示例默認開啟了圖片壓縮(超過一定尺寸自動縮放)。如果業務要求上傳原圖,初始化時加上:
compress: false
3. 打開文件類型限制
官方示例裡 accept 配置被註釋掉了,導致可以選任意文件。如果只允許上傳圖片,需要把它取消註釋:
accept: {
title: 'Images',
extensions: 'gif,jpg,jpeg,bmp,png',
mimeTypes: 'image/*'
}
4. 像素校驗放在 uploadAccept 階段
插件本身的 File 類封裝了文件信息,但沒有單獨暴露像素屬性,所以尺寸判斷只能放到後端。做法是上傳完成後在後端校驗,通過 uploadAccept 回調根據返回狀態決定是否接受:
uploader.on('uploadAccept', function (object, ret) {
var resJson = $.parseJSON(ret._raw);
if (resJson.result == 'error') {
alert(object.file.name + ' 象素太低,請檢查上傳!');
return false; // 返回 false 會讓該文件上傳失敗
}
});
這個回調返回 false 時,WebUploader 會把該文件標記為失敗,界面上的狀態也會同步更新,用戶能直觀看到哪張圖沒通過。
總體來說,WebUploader 的配置項設計得相當清晰,遷移成本主要在於「把示例裡被註釋掉的能力按需打開」和「後端接口對齊」。把上面四處改完,一個可用的批量圖片上傳功能就跑起來了。