簡單記錄一下做 H5 上傳時寫的程式碼,以及踩到的幾個問題。
前端上傳檔案必須透過 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 撐滿整個容器確保可點擊範圍足夠大。
這邊寫得相當簡潔,只用了 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,本身並不難。真正需要花心思的是那些邊界情況:檔案格式與大小的雙重驗證、進度回饋、取消選擇的處理、以及行動端的格式相容性。細節決定成敗,做任何事情都該認真對待。