DIV CSS 佈局教程網

jQuery 上傳插件 WebUploader 使用指南
編輯:JQuery入門技巧     

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 會把該文件標記為失敗,界面上的狀態也會同步更新,用戶能直觀看到哪張圖沒通過。

幾個實用提醒

  • 像素校驗放後端是被迫的妥協。更理想的做法是在 fileQueued 階段就用 createObjectURL 加 Image 對象讀取實際尺寸,不合格直接 reject,避免無效的上傳流量。前端校驗只是為了體驗,服務端校驗依然必須保留。
  • 大文件記得開 chunked。分片上傳配合 retry 能顯著提升弱網下的成功率,但後端需要相應的合併接口。
  • swf 路徑要相對於頁面而非 JS 文件。這是新手最常踩的坑之一,路徑錯了會導致 IE 下靜默失敗。
  • formData 是每次請求都會帶上的,適合放 token、業務 id 這類固定值;動態參數應該在 uploadBeforeSend 事件裡設置。
  • fileNumLimit 和 fileSizeLimit 是兩個不同層面:前者限制數量,後者限制累計體積,按業務需要組合使用。

總體來說,WebUploader 的配置項設計得相當清晰,遷移成本主要在於「把示例裡被註釋掉的能力按需打開」和「後端接口對齊」。把上面四處改完,一個可用的批量圖片上傳功能就跑起來了。

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