要用 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 事件負責回報進度。