DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 檔案上傳即時顯示進度條的實作教學
編輯:HTML5詳解     

傳統的表單上傳只能看著瀏覽器轉圈圈,完全不知道進度跑到哪裡。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;
}

三、用 FormData 搭配 XHR 上傳

點擊按鈕後執行 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 設定。此外,伺服器端務必加上副檔名白名單與檔案大小限制,避免任意檔案上傳的風險。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved