DIV CSS 佈局教程網

改造 ajaxFileUpload.js 使其支援多檔案上傳
編輯:關於JavaScript     

前提條件

使用 ajaxFileUpload.js 插件,並將其改寫為支援多檔案上傳。

步驟一:修改原始碼

原插件只支援單一檔案,需要改動處理 fileElementId 的那一段。

// 修改前
// var oldElement = jQuery('#' + fileElementId);
// var newElement = jQuery(oldElement).clone();
// jQuery(oldElement).attr('id', fileId);
// jQuery(oldElement).before(newElement);
// jQuery(oldElement).appendTo(form);

// 修改後:改為遍歷所有 fileElementId
for (var i in fileElementId) {
  var oldElement = jQuery('#' + fileElementId[i]);
  var newElement = jQuery(oldElement).clone();
  jQuery(oldElement).attr('id', fileId);
  jQuery(oldElement).before(newElement);
  jQuery(oldElement).appendTo(form);
}

關鍵差異是把單一元素的操作包進迴圈,同時在表單中插入一個克隆節點,讓同一個 file input 可以重複被選擇。

步驟二:呼叫方式

$.ajaxFileUpload({
  url: "./upload/upload.action",
  secureuri: false,
  // fileElementId: 'uploadfile1',   // 原本的用法
  fileElementId: ['uploadfile1', 'uploadfile2', 'uploadfile3', 'uploadfile4', 'uploadfile5'], // 現在的用法
  dataType: 'json',
  success: function (data) {
    ajaxLoadEnd();
    if (data.result == "success") {
      $.messager.alert('信息', '導入成功。', 'info');
    } else {
      $('#import_right').dialog('open');
      $.messager.alert('信息', '導入失敗。<br>錯誤信息:' + data.message, 'error');
    }
  },
  error: function (data, status, e) {
    ajaxLoadEnd();
    $.messager.alert('信息', '導入失敗。<br>錯誤信息:網絡異常或表單數據錯誤。', 'error');
  }
});

幾點實務提醒

這種「用偽 iframe 模擬非同步上傳」的手法,是 XMLHttpRequest 尚無法傳送檔案時期的產物。ajaxFileUpload 的原理是把表單 target 指向一個隱藏的 iframe,藉此避開整頁刷新。

今日已無此必要。FormData 搭配 fetch 或 $.ajax 就能原生處理多檔上傳,並可回報進度:

var fd = new FormData();
fd.append('files', document.getElementById('f1').files[0]);
fd.append('files', document.getElementById('f2').files[0]);

fetch('/upload', { method: 'POST', body: fd })
  .then(function (r) { return r.json(); })
  .then(function (data) { console.log(data); });

若使用 jQuery,別忘了加上 processData: false 與 contentType: false,否則 jQuery 會嘗試把 FormData 序列化而導致失敗——這是遷移時最常踩到的坑。

另外,改造後的程式碼用 for...in 遍歷陣列並不可靠(它會走訪所有可枚舉屬性,且順序不保證),應改用一般 for 迴圈或 forEach。上傳環節也務必在伺服器端驗證檔案型別與大小,前端限制只能改善體驗,不能作為安全措施。

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