第一個專案上線後回頭總結,最值得記錄的是圖片上傳這件事。當時整個表單資料都走 ajax,只為了傳一張圖去切換成 form 提交,總覺得很彆扭;那個時候也不知道有 jquery.form 這類插件可用。
後端同事最初給的方案是在 iframe 裡放一個 form,上傳完成後自動提交,再把圖片在伺服器上的路徑作為跳轉頁 URL 的一部分帶回來,前端負責截取。於是有了方案一。
<form action="/user/uploadIdCard.do" class="fileForm picUpload"
enctype="multipart/form-data" method="post">
<input type="file" id="uploadPic" name="file">
<label for="uploadPic" id="fileBtn">
<img src="" />
</label>
<input type="text" name="turnUrl" class="turnUrl">
</form>
$(".turnUrl").val(window.location.pathname);
$("#uploadPic").on('change', function (event) {
event.preventDefault();
$("form").submit();
});
在需要上傳圖片的頁面嵌入 iframe,再調用公用方法解析 iframe 內的跳轉位址,取出圖片路徑並回顯:
// 提取 iframe 內的狀態碼與路徑
function iframe(el) {
var code, filePath;
var place = $(el)[0].contentWindow.location.search;
if (!place) { return; }
code = place.match(/code=\d+/)[0].substr(5);
if (place.match(/filepath=\S+/)) {
filePath = place.match(/filepath=\S+/)[0].substr(9);
}
switch (code) {
case "200":
$(el).contents().find(".tip").text('上傳成功').css('color', '#55a012');
$(el).contents().find("#fileBtn>img").show().attr("src", "/" + filePath);
return "/" + filePath;
case "206":
$(el).contents().find(".tip").text('檔案過大');
break;
case "207":
$(el).contents().find(".tip").text('檔案類型錯誤');
break;
case "208":
$(el).contents().find(".tip").text('系統錯誤');
break;
}
}
第一,使用者上傳的原圖往往很大,而後端暫時沒有做壓縮。為了不阻塞進度,前端接手了壓縮工作。
第二,圖片要等 iframe 裡的頁面返回並跳轉後才會顯示,中間存在可感知的延遲。使用者常常以為「傳不上去」,其實只是後端還沒回應。
改用 HTML5 的 Canvas 在前端完成縮放與壓縮,再把 Base64 資料 POST 給後端:
<input type="file" id="uploadPic" name="file"> <label for="uploadPic" id="fileBtn"> <img class="showPic" src="" /> </label> <span class="tip"> 請上傳圖片,大小在 2M 以內<br/> (圖片類型可為 jpg, jpeg, png, gif, bmp)<br/> 推薦圖片比例為 640*400 </span> <input type="text" name="turnUrl" class="turnUrl"> <canvas id="uploadImg" style="display:none"></canvas>
$("#uploadPic").on('change', function (event) {
event.preventDefault();
var file = $(this)[0].files[0];
if (file.size > 2097152) {
alert("上傳圖片請小於 2M");
return false;
}
if (!/image\/\w+/.test(file.type)) {
alert("檔案必須為圖片!");
return false;
}
var reader = new FileReader();
reader.readAsDataURL(file);
reader.onload = function (e) {
createCanvas(this.result);
};
});
function createCanvas(src) {
var canvas = document.getElementById("uploadImg");
var cxt = canvas.getContext('2d');
canvas.width = 640;
canvas.height = 400;
var img = new Image();
img.src = src;
img.onload = function () {
cxt.drawImage(img, 0, 0, 640, 400);
// 先把處理後的圖顯示出來,讓使用者立刻看到結果
$(".showPic").show().attr('src', canvas.toDataURL("image/jpeg", 0.9));
$.ajax({
url: "/front/uploadByBase64.do",
type: "POST",
data: { "imgStr": canvas.toDataURL("image/jpeg", 0.9).split(',')[1] },
success: function (data) {
$(".showPic").show().attr('data-url', "/" + data.url);
}
});
};
}
file.size 檢查大小、file.type 檢查是否為圖片。canvas.toDataURL("image/jpeg", 0.9) 把結果直接渲染到頁面,使用者立即看到預覽;第二個參數即畫質,0~1 之間越低檔案越小。兩個方案都有一個共同的副作用:會在後端留下大量未被引用的冗餘圖片(使用者選了圖又改主意、請求失敗等)。理想做法是加上定時清理機制或改用先換 token、確認後才真正落盤的兩段式流程。
而從體驗角度看,方案二明顯更好:前端壓縮減少了流量與後端壓力,本地預覽消除了等待焦慮,統一尺寸也讓後續排版更可控。