利用 `
<form id="uploadForm" action="/api/upload" method="post" enctype="multipart/form-data" target="uploadIframe">
<input type="file" name="file" id="fileInput" accept=".xlsx,.xls,.csv" required>
<button type="submit">導入 Excel</button>
</form>
<iframe id="uploadIframe" name="uploadIframe" style="display: none;"></iframe>
<div id="result" style="margin-top: 10px;"></div>
$(function() {
$('#uploadForm').on('submit', function() {
// 顯示加載狀態
$('#result').html('<span class="loading">上傳中...</span>');
});
$('#uploadIframe').on('load', function() {
try {
// 獲取 iframe 內容
const iframe = this;
const doc = iframe.contentDocument || iframe.contentWindow.document;
const responseText = $(doc.body).text().trim();
if (!responseText) return; // 首次加載空頁面觸發
// 解析後端返回 (約定 JSON 格式)
let result;
try {
result = JSON.parse(responseText);
} catch (e) {
// 兼容非 JSON 返回
result = { success: false, message: responseText };
}
// 處理結果
if (result.success) {
$('#result').html(`<span class="success">${result.message || '上傳成功'}</span>`);
// 觸發業務回調
if (typeof onUploadSuccess === 'function') onUploadSuccess(result.data);
} else {
$('#result').html(`<span class="error">${result.message || '上傳失敗'}</span>`);
}
} catch (e) {
console.error('Iframe 回調異常:', e);
$('#result').html('<span class="error">響應解析失敗</span>');
}
});
});
// 成功
{ "success": true, "message": "導入 100 條數據", "data": { "count": 100 } }
// 失敗
{ "success": false, "message": "文件格式錯誤:必須為 .xlsx" }
// 服務端注意:設置 Content-Type: text/html (iframe 需要) 或 application/json
// 且必須返回完整 HTML 頁面或純文本,iframe 才能正確觸發 onload
// 簡單返回 JSON 字符串即可,瀏覽器會包裝在 中
const doc = iframe.contentDocument || iframe.contentWindow.document;
$('#uploadIframe').on('load', function() {
if (this._loaded) return; // 標誌位
this._loaded = true;
// 處理邏輯...
// 重置以便下次提交
setTimeout(() => { this._loaded = false; }, 100);
});
function resetForm() {
$('#uploadForm')[0].reset(); // 原生 reset 清空文件選擇
// 或僅清空文件輸入
$('#fileInput').val('');
}
$.fn.iframeUpload = function(options) {
const defaults = {
url: '',
paramName: 'file',
onStart: $.noop,
onSuccess: $.noop,
onError: $.noop,
onComplete: $.noop
};
const opts = $.extend({}, defaults, options);
return this.each(function() {
const $form = $(this);
const iframeId = 'uploadIframe_' + Date.now();
// 動態創建隱藏 iframe
const $iframe = $(`<iframe name="${iframeId}" style="display:none;"></iframe>`).appendTo('body');
$form.attr('target', iframeId).attr('action', opts.url);
$iframe.on('load', function() {
const doc = this.contentDocument || this.contentWindow.document;
const text = $(doc.body).text();
if (!text) return;
let result;
try { result = JSON.parse(text); }
catch (e) { result = { success: false, message: text }; }
if (result.success) opts.onSuccess(result.data, result.message);
else opts.onError(result.message);
opts.onComplete(result);
});
$form.on('submit', function() {
opts.onStart();
});
});
};
// 使用
$('#uploadForm').iframeUpload({
url: '/api/import',
onStart: () => $('#status').text('上傳中...'),
onSuccess: (data, msg) => $('#status').text('成功: ' + msg).removeClass('error').addClass('success'),
onError: (msg) => $('#status').text('失敗: ' + msg).removeClass('success').addClass('error')
});
| 局限 | 說明 |
|---|---|
| 無法獲取上傳進度 | 無 ProgressEvent |
| 錯誤處理困難 | 網絡錯誤、HTTP 非 2xx 不易捕獲 |
| 跨域受限 | 同源策略限制訪問 iframe contentDocument |
| 內存洩漏風險 | 動態創建 iframe 需及時移除 |
async function uploadFile(file) {
const formData = new FormData();
formData.append('file', file);
try {
const response = await fetch('/api/upload', {
method: 'POST',
body: formData
});
const result = await response.json();
return result;
} catch (err) {
throw new Error('網絡錯誤: ' + err.message);
}
}
// 進度顯示需用 XMLHttpRequest
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = e => {
if (e.lengthComputable) console.log(e.loaded / e.total * 100 + '%');
};
xhr.open('POST', '/api/upload');
xhr.send(formData);
Hidden Iframe 方案是 **Ajax 出現前** 及 **早期 IE 不支持 FormData** 時的標準無刷新上傳方案。現代項目(IE10+)請**優先使用 Fetch/XHR + FormData**,支持進度、取消、錯誤處理、跨域(CORS),代碼更簡潔標準。僅在必須兼容極舊環境時使用 iframe 方案。