利用 HTML5 Drag & Drop API 搭配 FormData 與 XMLHttpRequest,配合 PHP 後端處理,可快速構建現代化拖曳上傳體驗。本文提供完整前後端代碼與關鍵點解析。
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>拖曳上傳示例</title>
<style>
#dropZone { width:300px; height:200px; border:2px dashed #ccc; text-align:center; line-height:200px; color:#999; }
#dropZone.dragOver { border-color:#007bff; background:#f0f8ff; color:#007bff; }
</style>
</head>
<body>
<div id="dropZone">請拖入檔案至此上傳</div>
<script src="xhr-polyfill.js"></script> <!-- 兼容舊版 IE 的 XHR 封裝 -->
<script>
var dropZone = document.getElementById('dropZone');
['dragenter', 'dragover', 'dragleave', 'drop'].forEach(function(evt) {
dropZone.addEventListener(evt, preventDefaults, false);
});
function preventDefaults(e) { e.preventDefault(); e.stopPropagation(); }
['dragenter', 'dragover'].forEach(function(evt) {
dropZone.addEventListener(evt, function() { dropZone.classList.add('dragOver'); }, false);
});
['dragleave', 'drop'].forEach(function(evt) {
dropZone.addEventListener(evt, function() { dropZone.classList.remove('dragOver'); }, false);
});
dropZone.addEventListener('drop', handleDrop, false);
function handleDrop(e) {
var file = e.dataTransfer.files[0]; // 單檔示例,多檔請遍歷 files
if (!file) return;
var formData = new FormData();
formData.append('file', file);
var xhr = createXHR(); // 見下方兼容封裝
xhr.open('POST', 'upload.php', true);
xhr.upload.onprogress = function(e) {
if (e.lengthComputable) {
var percent = Math.round((e.loaded / e.total) * 100);
dropZone.textContent = '上傳中 ' + percent + '%';
}
};
xhr.onload = function() {
if (xhr.status === 200) {
dropZone.textContent = '上傳成功:' + xhr.responseText;
dropZone.style.color = 'green';
} else {
dropZone.textContent = '上傳失敗:' + xhr.status;
dropZone.style.color = 'red';
}
};
xhr.onerror = function() {
dropZone.textContent = '網路錯誤';
dropZone.style.color = 'red';
};
xhr.send(formData);
}
// 兼容封裝:優先標準 XHR,回退 ActiveXObject
function createXHR() {
if (window.XMLHttpRequest) return new XMLHttpRequest();
try { return new ActiveXObject('Msxml2.XMLHTTP'); } catch(e) {}
try { return new ActiveXObject('Microsoft.XMLHTTP'); } catch(e) {}
throw new Error('瀏覽器不支援 AJAX');
}
</script>
</body>
</html>
<?php
header('Content-Type: text/plain; charset=utf-8');
$targetDir = __DIR__ . '/uploads/';
if (!is_dir($targetDir)) mkdir($targetDir, 0755, true);
$inputName = 'file'; // 對應前端 formData.append('file', ...)
if (isset($_FILES[$inputName]) && $_FILES[$inputName]['error'] === UPLOAD_ERR_OK) {
$tmpName = $_FILES[$inputName]['tmp_name'];
$origName = basename($_FILES[$inputName]['name']);
// 防止檔名衝突與安全風險:建議重命名
$ext = pathinfo($origName, PATHINFO_EXTENSION);
$newName = uniqid('upload_', true) . '.' . $ext;
$destPath = $targetDir . $newName;
if (move_uploaded_file($tmpName, $destPath)) {
echo '檔案已儲存:' . $newName;
} else {
http_response_code(500);
echo '移動檔案失敗';
}
} else {
http_response_code(400);
echo '無效上傳:' . ($_FILES[$inputName]['error'] ?? '未收到檔案');
}
dragenter/dragover 必須 preventDefault() 才能觸發 drop;drop 事件中透過 e.dataTransfer.files 取得 FileList。multipart/form-data 請求體,支援二進位檔案直接上傳,無需 Base64 編碼。xhr.upload.onprogress 即時顯示上傳進度,提升體驗。$_FILES['error']、限制副檔名/MIME、重命名儲存、設定上傳目錄權限、防止腳本執行(.htaccess 禁用 PHP 解析)。FileReader.readAsDataURL)、壓縮(Canvas 壓縮後再上傳)。此範例展示了現代瀏覽器原生 API 搭配傳統 PHP 即可構建優雅的拖曳上傳功能,代碼簡潔、無第三方依賴,適合快速原型與中小專案直接採用。