DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 非同步上傳檔案實作:跨域支援與即時進度條
編輯:HTML5教程     

傳統表單上傳檔案只能等,畫面會凍結到上傳結束。HTML5 的 XMLHttpRequest 加上 FormData,讓我們可以做到非同步上傳、即時進度條,還能跨域送出。

步驟一:伺服器端設定(以 IIS 為例)

跨域的前提是伺服器必須回應正確的標頭。在 IIS 的「HTTP 回應標頭」中新增一項 Access-Control-Allow-Origin:

少了這行,Chrome 等瀏覽器會直接以 CORS 政策為由攔下請求,前端連錯誤細節都拿不到。注意:這個標頭是回應標頭,要由伺服器設定,在前端用 xhr.setRequestHeader 設定是無效的(註解中那行就是常見的誤解)。正式環境請把 * 換成明確的來源網域,避免使用 * 搭配 credential。

步驟二:頁面程式碼

<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="content-type" content="text/html;charset=utf-8">
    <meta name="format-detection" content="telephone=no">
    <meta name="msapplication-tap-highlight" content="no">
    <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width">
    <title>Html5 上傳文件</title>
</head>
<body>
<div class="app">
    <h1>Html5 上傳文件測試,帶進度條</h1>
    <div>
        <input type="file" value="" id="fileInput" name="files" onchange="fileSelected()" />
        <div style="margin:30px;">
            <input type="button" value="上傳" onclick="uploadFile()" />
        </div>
        <div style="margin:30px;">
            <div id="fileName"></div>
            <div id="fileSize"></div>
            <div id="fileType"></div>
        </div>
        <div style="margin:30px;width:500px;height:15px;border:1px solid #aeaeae;">
            <div id="progress" style="background:#4cff00;height:15px;width:0%;"></div>
            <div id="percentNumber"></div>
        </div>
        <div style="margin:30px;">
            <div id="msg"></div>
        </div>
    </div>
</div>
<script type="text/javascript">
function fileSelected() {
    // 重設狀態顯示
    document.getElementById("msg").innerHTML = "";
    document.getElementById('percentNumber').innerHTML = '';
    document.getElementById("progress").style.width = "0%";

    var file = document.getElementById('fileInput').files[0];
    if (file) {
        var fileSize = 0;
        if (file.size > 1024 * 1024)
            fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB';
        else
            fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB';

        document.getElementById('fileName').innerHTML = 'Name: ' + file.name;
        document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize;
        document.getElementById('fileType').innerHTML = 'Type: ' + file.type;
    }
}

function uploadFile() {
    var fd = new FormData();
    fd.append("fileInput", document.getElementById('fileInput').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", "https://10.0.0.200:9001/Home/Upload"); // 改為自己的伺服器介面
    // 跨域標頭必須在 IIS(伺服器端)設定,前端設定無效
    // 使用 FormData 時不要手動設定 Content-Type,瀏覽器會自行加上 boundary
    xhr.send(fd);
}

function uploadProgress(evt) {
    if (evt.lengthComputable) {
        var percentComplete = Math.round(evt.loaded * 100 / evt.total);
        document.getElementById('percentNumber').innerHTML = percentComplete + '%';
        document.getElementById("progress").style.width = percentComplete + "%";
    } else {
        document.getElementById('percentNumber').innerHTML = '不支持進度計算';
    }
}

function uploadComplete(evt) {
    // evt.target.responseText 可取得伺服器回應
    document.getElementById("msg").innerHTML = "上傳成功";
}

function uploadFailed(evt) {
    document.getElementById("msg").innerHTML = "上傳過程中有一個錯誤";
}

function uploadCanceled(evt) {
    document.getElementById("msg").innerHTML = "用戶取消了上傳或者瀏覽器刪除了連接";
}
</script>
</body>
</html>

幾個實作要點

1. FormData 是關鍵。它把 File 物件包裝成 multipart/form-data 格式,後端可以像處理一般表單上傳那樣接收,不必改動既有 API。

2. 不要手動設 Content-Type。註解裡那行 xhr.setRequestHeader("Content-Type", "multipart/form-data") 是常見錯誤——少了 boundary 參數,後端會無法解析表單內容。讓瀏覽器自動產生才是正解。

3. 進度監聽要掛在 xhr.upload 上。掛在 xhr 本身只會在取得回應時觸發,拿不到上傳中的進度。另外 lengthComputable 為 false 時表示瀏覽器無法得知總量,此時只能顯示不確定型態的動畫。

4. 記得處理失敗與取消。範例已綁定 error 與 abort 事件,這在行動網路不穩時尤其重要,否則使用者只會看到進度條卡住不動。

5. 前端檢查不能取代後端驗證。file.type 與副檔名都可以被竄改,實際的型別、大小與內容檢查仍必須在伺服器端進行。

結語

這套 HTML5 上傳方案搭配伺服器端的 CORS 標頭設定,就能實現跨域、非同步、有進度回饋的檔案上傳體驗。若需要更進階的功能(分片上傳、斷點續傳、多檔佇列),可以在這份基礎上加上 File.slice() 與 Content-Range 的處理。

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