經典 jquery.ajaxFileUpload.js 原版不支持附加表單字段。本文詳解修改源碼添加 data 參數的兩處關鍵點,並提供現代 FormData + fetch/axios 的零依賴替代方案。
$.ajaxFileUpload({
url: '/upload',
fileElementId: 'fileInput',
dataType: 'json',
success: function(res) { ... }
});
// 原版簽名
createUploadForm: function(id, fileElementId) { ... }
// 修改為:接收 data 參數
createUploadForm: function(id, fileElementId, data) {
// ... 原有創建 form、file input 邏輯 ...
// 新增:處理附加數據,追加 hidden input
if (data) {
for (var key in data) {
if (data.hasOwnProperty(key)) {
$('')
.appendTo(form);
}
}
}
return form;
}
// 原版
var form = jQuery.createUploadForm(id, s.fileElementId);
// 修改:傳入 s.data
var form = jQuery.createUploadForm(id, s.fileElementId, s.data);
$.ajaxFileUpload({
url: '/upload',
fileElementId: 'fileInput',
data: { // 新增:附加業務參數
userId: 12345,
category: 'avatar',
token: 'xyz'
},
dataType: 'json',
success: function(res) { console.log(res); }
});
ajaxFileUpload 內部動態創建 <form target="iframe" method="post" enctype="multipart/form-data"><input type="file"> 移動到該 form<iframe> 作為 form 提交目標<input type="hidden"> 到 formasync function uploadFile(fileInputId, extraData) {
const fileInput = document.getElementById(fileInputId);
const file = fileInput.files[0];
if (!file) throw new Error('未選擇文件');
const formData = new FormData();
formData.append('file', file); // 文件字段名需與後端一致
// 附加業務參數
Object.entries(extraData || {}).forEach(([key, val]) => {
formData.append(key, val);
});
try {
const response = await fetch('/upload', {
method: 'POST',
body: formData,
// 不設置 Content-Type!瀏覽器自動設置 multipart/form-data; boundary=...
credentials: 'include' // 攜帶 Cookie
});
if (!response.ok) throw new Error('HTTP ' + response.status);
return await response.json();
} catch (err) {
console.error('上傳失敗:', err);
throw err;
}
}
// 使用
uploadFile('fileInput', {userId: 12345, category: 'avatar'})
.then(res => console.log('成功:', res))
.catch(err => alert('上傳失敗: ' + err.message));
import axios from 'axios';
async function uploadWithAxios(file, extraData) {
const formData = new FormData();
formData.append('file', file);
Object.entries(extraData).forEach(([k, v]) => formData.append(k, v));
return axios.post('/upload', formData, {
headers: {'Content-Type': 'multipart/form-data'}, // axios 會自動設置 boundary
onUploadProgress: (e) => {
const percent = Math.round((e.loaded * 100) / e.total);
console.log('進度:', percent + '%');
}
});
}
async function chunkedUpload(file, chunkSize = 2 * 1024 * 1024) {
const totalChunks = Math.ceil(file.size / chunkSize);
const fileHash = await calculateHash(file); // SparkMD5 等
for (let i = 0; i < totalChunks; i++) {
const start = i * chunkSize;
const chunk = file.slice(start, start + chunkSize);
const formData = new FormData();
formData.append('chunk', chunk);
formData.append('chunkIndex', i);
formData.append('totalChunks', totalChunks);
formData.append('fileHash', fileHash);
formData.append('fileName', file.name);
await fetch('/upload/chunk', {method: 'POST', body: formData});
// 可在此更新進度條
}
// 通知後端合併
return fetch('/upload/merge', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({fileHash, fileName: file.name})
});
}
| 場景 | 推薦方案 |
|---|---|
| 維護老項目、不想引入構建工具 | 修改 ajaxFileUpload.js 源碼 |
| 新項目、現代瀏覽器環境 | FormData + Fetch (原生) |
| 項目已用 Axios/Vue/React | Axios + FormData |
| 大文件、斷點續傳、秒傳 | 分片上傳 + Web Worker 計算哈希 |
| 需要拖拽、預覽、壓縮圖片 | Uppy、FilePond、Dropzone 等成熟組件 |
理解 iframe 上傳原理,有助於在無現代 API 環境下快速實現文件上傳;但新項目請毫猶豫選擇 FormData + Fetch。