傳統的表單上傳只能看著瀏覽器轉圈圈,完全不知道進度跑到哪裡。HTML5 帶來的 XMLHttpRequest 進階能力與 FormData 物件,讓我們可以在前端直接監聽上傳事件、把百分比即時呈現在頁面上。以下以 ASP.NET MVC 作為伺服器端示範,換成 PHP、Node.js 或其他語言邏輯也完全一樣。
先在視圖裡放一個多檔選擇的檔案輸入框,再預留幾個容器用來顯示檔名、大小、型別與進度數字。
@using (Html.BeginForm("Upload", "Home", FormMethod.Post,
new { enctype = "multipart/form-data", id = "form1" }))
{
<div class="row">
<label for="fileToUpload">Upload Image:</label>
<input type="file" name="fileToUpload" id="fileToUpload"
multiple="multiple" onchange="fileSelected();" />
</div>
<div id="fileName"></div>
<div id="fileSize"></div>
<div id="fileType"></div>
<div class="row">
<input type="button" onclick="uploadFile()" value="Upload Image" />
</div>
<div id="progressNumber"></div>
}
onchange 觸發 fileSelected,透過 File API 就能取得原生物件,讀取 name、size、type 等屬性,並順手把位元組換算成人類看得懂的 KB 或 MB。
function fileSelected() {
var file = document.getElementById('fileToUpload').files[0];
if (!file) return;
var fileSize = 0;
if (file.size > 1024 * 1024) {
fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100) + 'MB';
} else {
fileSize = (Math.round(file.size * 100 / 1024) / 100) + 'KB';
}
document.getElementById('fileName').innerHTML = 'Name: ' + file.name;
document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize;
document.getElementById('fileType').innerHTML = 'Type: ' + file.type;
}
點擊按鈕後執行 uploadFile。這裡並沒有設定表單的 Content-Type,而是交由瀏覽器在送出 FormData 時自動補上 multipart/form-data 的 boundary,這一點非常重要,手動設定反而會導致伺服器解析失敗。
function uploadFile() {
var fd = new FormData();
fd.append('fileToUpload', document.getElementById('fileToUpload').files[0]);
var xhr = new XMLHttpRequest();
xhr.upload.addEventListener('progress', uploadProgress, false);
xhr.addEventListener('load', uploadComplete, false);
xhr.addEventListener('error', uploadFailed, false);
xhr.addEventListener('abort', uploadCanceled, false);
xhr.open('POST', 'Home/Upload');
xhr.send(fd);
}
進度事件的關鍵在於 evt.lengthComputable:只有在伺服器回傳的 Content-Length 可取得時,才能算出百分比;否則就老實顯示無法計算。
function uploadProgress(evt) {
if (evt.lengthComputable) {
var percentComplete = Math.round(evt.loaded * 100 / evt.total);
document.getElementById('progressNumber').innerHTML =
percentComplete.toString() + '%';
} else {
document.getElementById('progressNumber').innerHTML = 'unable to compute';
}
}
function uploadComplete(evt) {
// 伺服器回應時觸發
alert(evt.target.responseText);
}
function uploadFailed(evt) {
alert('上傳過程中發生錯誤。');
}
function uploadCanceled(evt) {
alert('上傳已被使用者取消,或瀏覽器中止了連線。');
}
MVC 這邊只要一個標了 [HttpPost] 的 Action,參數型別對應前端 append 的名稱即可。
public class HomeController : Controller
{
public ActionResult Index()
{
return View();
}
/// <summary>
/// 接收並儲存上傳的檔案
/// </summary>
[HttpPost]
public ActionResult Upload(HttpPostedFileBase[] fileToUpload)
{
foreach (HttpPostedFileBase file in fileToUpload)
{
string path = System.IO.Path.Combine(
Server.MapPath("~/App_Data"),
System.IO.Path.GetFileName(file.FileName));
file.SaveAs(path);
}
ViewBag.Message = "File(s) uploaded successfully";
return RedirectToAction("Index");
}
}
上例以 Firefox 14 當時的環境撰寫,而 IE 9 完全不支援 File API,因此舊版 IE 需要另外搭配 Flash 上傳元件或降級為傳統表單。到了今天,各家主流瀏覽器都已完整支援 File API、FormData 與 XHR 進度事件,可以直接放心使用;若想更省事,也可以改用 fetch 搭配 ReadableStream,或用 axios 的 onUploadProgress 設定。此外,伺服器端務必加上副檔名白名單與檔案大小限制,避免任意檔案上傳的風險。