DIV CSS 佈局教程網

用 jQuery 與 Ajax 上傳檔案,並顯示上傳進度
編輯:AJAX基礎知識     

兩個關鍵物件

要用 Ajax 上傳檔案,需要 FormData 與 XMLHttpRequest 這兩個物件搭配。新版 Firefox、Chrome 等支援 HTML5 的瀏覽器對它們支援良好;IE9 尚未支援 FormData,仍在用 IE6 的團隊恐怕只能望門興嘆。

有了這兩個物件,真正的 Ajax 檔案上傳才成為可能。

基本版:把檔案送出去

 <!DOCTYPE html>
<html>
<head>
<title>Html5 Ajax 上傳檔案</title>
<script type="text/javascript">
function UpladFile() {
    var fileObj = document.getElementById("file").files[0];  // 取得檔案物件
    var FileController = "../file/save";                     // 後端接收位址

    // 用 FormData 包裝表單資料
    var form = new FormData();
    form.append("author", "hooyes");   // 可附加一般欄位
    form.append("file", fileObj);      // 加入檔案物件

    // 用 XMLHttpRequest 送出
    var xhr = new XMLHttpRequest();
    xhr.open("post", FileController, true);
    xhr.onload = function () {
        alert("上傳完成!");
    };
    xhr.send(form);
}
</script>
</head>
<body>
<input type="file" id="file" name="myfile" />
<input type="button" onclick="UpladFile()" value="上傳" />
</body>
</html>

程式碼相當精簡。這裡用傳統的 <input type="file" /> 取得檔案物件,HTML5 另外還支援把檔案拖曳到指定元素上等多種更靈活的方式。

進階版:加上進度條

檔案上傳得成,第一個浮上心頭的問題往往是「進度呢?」過去可能會想到 Flash 或瀏覽器插件,現在完全不需要——HTML5 直接提供了 <progress> 標籤:

 <progress id="progressBar" value="0" max="100"></progress>

瀏覽器會把它渲染成一個進度條,接下來只要在的上傳過程中即時改變它的 value 即可。伺服器端完全不必修改,只需在 XHR 物件上多掛一個事件:

 xhr.upload.addEventListener("progress", progressFunction, false);

progressFunction 被呼叫時會收到一個事件物件,其中 lengthComputable、loaded、total 分別代表長度是否可計算、已上傳量與總量:

 function progressFunction(evt) {
     var progressBar = document.getElementById("progressBar");
     if (evt.lengthComputable) {
         progressBar.max = evt.total;
         progressBar.value = evt.loaded;
     }
 }

完整範例

 <!DOCTYPE html>
<html>
<head>
<title>Html5 Ajax 上傳檔案</title>
<script type="text/javascript">
function UpladFile() {
    var fileObj = document.getElementById("file").files[0];  // 取得檔案物件
    var FileController = "../file/save";                     // 後端接收位址

    var form = new FormData();
    form.append("author", "hooyes");
    form.append("file", fileObj);

    var xhr = new XMLHttpRequest();
    xhr.open("post", FileController, true);
    xhr.onload = function () {
        alert("上傳完成!");
    };
    xhr.upload.addEventListener("progress", progressFunction, false);
    xhr.send(form);
}

function progressFunction(evt) {
    var progressBar = document.getElementById("progressBar");
    var percentageDiv = document.getElementById("percentage");
    if (evt.lengthComputable) {
        progressBar.max = evt.total;
        progressBar.value = evt.loaded;
        percentageDiv.innerHTML = Math.round(evt.loaded / evt.total * 100) + "%";
    }
}
</script>
</head>
<body>
<progress id="progressBar" value="0" max="100"></progress>
<span id="percentage"></span>
<br />
<input type="file" id="file" name="myfile" />
<input type="button" onclick="UpladFile()" value="上傳" />
</body>
</html>

後端接收

接收端可以用任何語言撰寫(C#、PHP、Python 等),以下以 C# 為例,邏輯簡單到不必為進度條做任何配合:

 var flist = Request.Files;
 for (int i = 0; i < flist.Count; i++) {
     string FilePath = "E:\\hooyes\\Files\\";
     var c = flist[i];
     FilePath = Path.Combine(FilePath, c.FileName);
     c.SaveAs(FilePath);
 }

整體來說,HTML5 把過去需要外掛才能做到的事,收攏成幾個原生 API:FormData 負責打包、XMLHttpRequest 負責傳輸、progress 事件負責回報進度。

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