在 FormData + XMLHttpRequest Level 2 / fetch 普及前,利用隱藏 iframe 作為表單提交目標(target 屬性),是實現「無刷新檔案上傳」的經典方案。雖然現代瀏覽器已全面支援 AJAX 上傳,但理解此機制有助於維護舊專案與理解檔案上傳本質。
<form name="multiform" id="multiform" action="multi-form-submit.php" method="POST" enctype="multipart/form-data">
姓名: <input type="text" name="name" value="Ravi" /><br/>
年齡 : <input type="text" name="age" value="1" /><br/>
頭像 : <input type="file" name="photo" /><br/>
<input type="button" id="multi-post" value="提交" />
</form>
<div id="multi-msg"></div>
關鍵點:enctype="multipart/form-data"、無 target 屬性(由 JS 動態指定)。
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(document).ready(function() {
// 統一取得 iframe 的 document 物件 (跨瀏覽器相容)
function getDoc(frame) {
var doc = null;
try {
if (frame.contentWindow) {
doc = frame.contentWindow.document;
}
} catch (err) {}
if (doc) return doc;
try {
doc = frame.contentDocument ? frame.contentDocument : frame.document;
} catch (err) {}
return doc;
}
// 核心:將表單提交到動態建立的隱藏 iframe
function postToIframe(formObj, callback) {
$("#multi-msg").html("<img src='loading.gif'/>");
var formURL = formObj.attr("action");
// 1. 產生唯一 iframe 名稱
var iframeId = 'upload_iframe_' + (new Date().getTime());
// 2. 建立隱藏 iframe
var $iframe = $('
<?php
// 實際專案應加入:檔案型別驗證、大小限制、隨機檔名、資料庫記錄等
header('Content-Type: application/json; charset=utf-8');
$response = [
'success' => true,
'files' => $_FILES,
'post' => $_POST,
'message' => '上傳成功'
];
// 處理上傳檔案
if (isset($_FILES['photo']) && $_FILES['photo']['error'] === UPLOAD_ERR_OK) {
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);
$dest = $uploadDir . basename($_FILES['photo']['name']);
move_uploaded_file($_FILES['photo']['tmp_name'], $dest);
$response['saved_path'] = $dest;
}
echo json_encode($response);
?>
1. 使用者點擊提交
↓
2. JS 建立隱藏 iframe (name=upload_iframe_123456)
↓
3. 表單 target = "upload_iframe_123456"
↓
4. 表單提交 → 瀏覽器在 iframe 中載入回應
↓
5. iframe 觸發 onload 事件
↓
6. JS 讀取 iframe.document.body.innerHTML 取得回應
↓
7. 解析回應、更新 UI、移除 iframe
| 細節 | 說明 |
|---|---|
src="javascript:false;" | 避免 HTTPS 頁面載入 HTTP iframe 產生混合內容警告 |
$iframe.hide() | 不使用 display:none 避免某些瀏覽器不觸發 load |
getDoc() 多重嘗試 | 相容 IE8 SSL、跨域、舊版瀏覽器差異 |
setTimeout remove | 確保回應已完全讀取後再移除 iframe |
e.preventDefault() | 阻止表單預設提交(會導致頁面跳轉) |
FormData + fetch (推薦)async function uploadFile(formElement) {
const formData = new FormData(formElement);
const response = await fetch(formElement.action, {
method: 'POST',
body: formData
// 不要手動設定 Content-Type,瀏覽器會自動設定 multipart/form-data + boundary
});
if (!response.ok) throw new Error('上傳失敗: ' + response.status);
return await response.json();
}
// 使用
document.getElementById('multiform').addEventListener('submit', async (e) => {
e.preventDefault();
$('#multi-msg').html("
");
try {
const result = await uploadFile(e.target);
$('#multi-msg').html("成功: " + JSON.stringify(result, null, 2) + "
");
} catch (err) {
$('#multi-msg').html("錯誤: " + err.message + "
");
}
});
iframe 方案**無法取得上傳進度**。現代 XMLHttpRequest / fetch (配合 ReadableStream) 支援進度監聽:
// XMLHttpRequest 版 (支援進度)
var xhr = new XMLHttpRequest();
xhr.upload.addEventListener('progress', function(e) {
if (e.lengthComputable) {
var percent = Math.round((e.loaded / e.total) * 100);
$('#progress-bar').css('width', percent + '%').text(percent + '%');
}
});
xhr.open('POST', '/upload');
xhr.send(formData);
iframe 檔案上傳是「駭客式」解法,利用瀏覽器原生表單提交機制繞過早期 AJAX 無法上傳檔案的限制。現代專案**請直接使用 FormData + fetch**,獲得更好的錯誤處理、進度顯示、取消上傳、TypeScript 型別支援等優勢。僅在維護 IE9 以下舊系統時才需使用 iframe 方案。