DIV CSS 佈局教程網

HTML5 + JavaScript 檔案上傳實作:樣式客製與實務上的幾個坑
編輯:關於JavaScript     

簡單記錄一下做 H5 上傳時寫的程式碼,以及踩到的幾個問題。

一、外觀問題:原生 file input 太醜

前端上傳檔案必須透過 form 表單,無法直接用 ajax。而一個 type="file" 的 input 放在行動版頁面上,預設外觀實在稱不上美觀:

PC 端常見的解法是用 Flash 或 uploadify 這類工具庫替換掉它,但行動端瀏覽器大多不支援 Flash,此路不通。

最後採用的方法是保留 form 表單,但把 opacity 設為 0,讓它覆蓋在自訂的視覺元素上。使用者看到的是自己設計的樣式,點擊時實際觸發的卻是原生的檔案選擇器。

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1.0,user-scalable=no">
<title></title>
<style>
div { width: 100%; }
.logo img { display: block; margin: 0 auto; }
.upload {
    position: relative;
    width: 80px;
    height: 18px;
    line-height: 18px;
    background: #2fc7c9;
    text-align: center;
    color: #FFF;
    padding: 0px 5px;
    -webkit-border-radius: 2px;
    border-radius: 2px;
    margin: 0 auto;
}
.upload form {
    width: 100%;
    position: absolute;
    left: 0;
    top: 0;
    opacity: 0;
    filter: alpha(opacity=0);
}
.upload form input { width: 100%; }
</style>
</head>
<body>
<div class="logo"><img src="img/1.jpg" /></div>
<div class="upload">
    <p>上傳圖片</p>
    <form><input type="file" /></form>
</div>
</body>
</html>

呈現出來就是一個乾淨的按鈕樣式,點擊「上傳圖片」文字即可開啟檔案選擇器。這個技巧的關鍵是 position: absolute 讓透明表單精確覆蓋在可見元素上,同時 input 撐滿整個容器確保可點擊範圍足夠大。

二、JavaScript 部分

這邊寫得相當簡潔,只用了 H5 上傳的基本功能。HTML 結構如下,action 為請求路徑;我在這裡做的是「檔案選擇變動後立即上傳頭像」,而 input 的 name 屬性不能省略,需依後端介面而定:

<form id="uploadForm" enctype="multipart/form-data" method="post" action="XXXXXX">
    <input type="file" name="imageFile" id="imageFile" onchange="fileSelected()" />
</form>
var iMaxFilesize = 2097152; // 2M

window.fileSelected = function () {
    var oFile = document.getElementById('imageFile').files[0]; // 讀取檔案

    var rFilter = /^(image\/bmp|image\/gif|image\/jpeg|image\/png|image\/tiff)$/i;
    if (!rFilter.test(oFile.type)) {
        alert("文件格式必須為圖片");
        return;
    }

    if (oFile.size > iMaxFilesize) {
        alert("圖片大小不能超過2M");
        return;
    }

    var vFD = new FormData(document.getElementById('uploadForm')),
        oXHR = new XMLHttpRequest();

    oXHR.addEventListener('load', function (resUpload) {
        // 成功處理
    }, false);
    oXHR.addEventListener('error', function () {
        // 失敗處理
    }, false);
    oXHR.addEventListener('abort', function () {
        // 上傳中斷
    }, false);

    oXHR.open('POST', actionUrl);
    oXHR.send(vFD);
};

三、幾個實務上會踩到的坑

1. 前端驗證只是第一道防線。用正則檢查 MIME 型別、用 size 檢查大小,都只是為了節省使用者的時間與頻寬。真正的驗證必須在伺服器端重做一遍,因為前端檢查可以被任意繞過。同時要留意 file.type 是依副檔名推測的,並非真正解析檔案內容。

2. 別忘了 enctype。form 必須加上 enctype="multipart/form-data",否則後端收到的會是亂碼。使用 FormData 時這點尤其容易忽略,因為看起來「有送出去」但內容是壞的。

3. 需要進度條時改用 upload.onprogress。上傳大檔案若沒有進度回饋,使用者會以為卡住了。可改用 oXHR.upload.addEventListener('progress', ...),從 event.loaded / event.total 算出百分比。

4. 行動端的特殊考量。若要限制只能選圖片,可在 input 上加 accept="image/*";若要調用相機,則加 capture 屬性。另外要注意 iOS 對 HEIC 格式的支援問題,可能需要在後端做格式轉換。

5. 未選擇檔案就觸發會報錯。files[0] 在使用者取消選擇時是 undefined,直接取 .type 會拋出例外。記得加上 if (!oFile) return; 的防禦。

6. 記得處理未捕捉的錯誤。範例中三個事件監聽器的內容都是空的,實際部署時至少要在 error 分支給使用者一個明確提示,並考慮加入重試機制。

小結

H5 上傳的核心 API 就是 FormData 加 XMLHttpRequest,本身並不難。真正需要花心思的是那些邊界情況:檔案格式與大小的雙重驗證、進度回饋、取消選擇的處理、以及行動端的格式相容性。細節決定成敗,做任何事情都該認真對待。

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