HTML5 提供了 File API 與拖放(Drag and Drop)機制,讓使用者能把檔案直接拖進瀏覽器完成上傳,大幅改善操作體驗。本文以 JSP 頁面搭配 Tomcat 伺服器為例,示範如何實作檔案的拖曳上傳與下載;若後端採用其他語言,前端部分同樣適用。
我們先建立一個拖放區域,當檔案拖曳其上時會高亮顯示,放開後即觸發處理。同時保留傳統的檔案選擇與送出按鈕作為後備方案。
<style type="text/CSS">
#filedrag {
display: none;
font-weight: bold;
text-align: center;
padding: 1em 0;
margin: 1em 0;
color: #555;
border: 2px dashed #555;
border-radius: 7px;
cursor: default;
}
#filedrag.hover {
color: #f00;
border-color: #f00;
border-style: solid;
box-shadow: inset 0 3px 4px #888;
}
</style>
<form id="upload" action="UploadServlet" enctype="multipart/form-data"
method="post" onsubmit="return upLoad();">
<label for="fileselect">file name:</label>
<input multiple="true" type="file" id="fileselect" name="fileselect[]" />
<div id="filedrag">或者將文件拖拽到這裡</div>
<div id="submitbutton"><input type="submit" value="提交"></div>
</form>
<div id="messages"></div>
關鍵在於監聽 dragover、dragleave 與 drop 事件,並從 dataTransfer.files 取得 FileList,最後用 XMLHttpRequest 搭配 FormData 以非同步方式上傳。
var upfiles = new Array();
function $id(id) { return document.getElementById(id); }
function Output(msg) { var m = $id("messages"); m.innerHTML = msg + m.innerHTML; }
function FileDragHover(e) {
e.stopPropagation();
e.preventDefault();
e.target.className = (e.type == "dragover" ? "hover" : "");
}
function FileSelectHandler(e) {
FileDragHover(e);
var files = e.target.files || e.dataTransfer.files;
for (var i = 0, f; f = files[i]; i++) {
ParseFile(f);
upfiles.push(f);
}
}
function ParseFile(file) {
Output("<p>文件信息: <strong>" + file.name + "</strong> 類型: <strong>" + file.type + "</strong> 大小: <strong>" + file.size + "</strong> bytes</p>");
}
function upLoad() {
if (upfiles[0]) {
var xhr = new XMLHttpRequest();
xhr.open("POST", "UploadServlet", true);
var formData = new FormData();
for (var i = 0, f; f = upfiles[i]; i++) { formData.append('myfile', f); }
xhr.send(formData);
xhr.onreadystatechange = function (e) { history.go(0); };
return false;
}
}
function Init() {
var fileselect = $id("fileselect"), filedrag = $id("filedrag");
fileselect.addEventListener("change", FileSelectHandler, false);
var xhr = new XMLHttpRequest();
if (xhr.upload) {
filedrag.addEventListener("dragover", FileDragHover, false);
filedrag.addEventListener("dragleave", FileDragHover, false);
filedrag.addEventListener("drop", FileSelectHandler, false);
filedrag.style.display = "block";
}
}
if (window.File && window.FileList && window.FileReader) { Init(); }
後端可搭配 jspSmartUpload 等元件完成檔案的儲存與下載。上傳時透過 setMaxFileSize 限制大小、setDeniedFilesList 排除危險格式(如 exe),並以 UTF-8 編碼處理中文檔名;下載時則依傳入的檔名,確認檔案存在後呼叫 downloadFile 輸出。實作時建議留意中文檔名的編碼處理,以避免亂碼問題。