圖片上傳是後台管理系統裡最常見的需求之一,但真正讓使用者用得順手的關鍵,往往不在後端,而在前端那一層「選檔之後能不能先看一眼」的體驗。本文直接從程式碼出發,示範兩種在 JavaScript 中實作圖片上傳頁面的思路:一種是純手寫的格式與大小檢查加預覽,另一種是借助成熟編輯器外掛快速搞定。
這個版本做三件事:攔截 onchange 事件、比對副檔名是否在允許清單中、抓取檔案大小避免上傳過大的圖片,最後把選中的圖片即時渲染到頁面的預覽區。其中最大的坑在於瀏覽器差異——Firefox 可以用 window.URL.createObjectURL 拿到 blob 位址,而舊版 IE 只能靠 AlphaImageLoader 濾鏡。
<script>
//檢查圖片的格式是否正確,同時實現預覽
function setImagePreview(obj, localImagId, imgObjPreview) {
var array = new Array('gif', 'jpeg', 'png', 'jpg', 'bmp'); //可以上傳的文件類型
if (obj.value == '') {
$.messager.alert("提示", "請選擇要上傳的圖片!");
flag = false;
return false;
} else {
var fileContentType = obj.value.match(/^(.*)(\.)(.{1,8})$/)[3]; //取得副檔名
var isExists = false;
var objValue = obj.value;
try {
//IE 透過 FileSystemObject 取得檔案大小
var fso = new ActiveXObject("Scripting.FileSystemObject");
fileLenth = parseInt(fso.getFile(objValue).size);
} catch (e) {
try {
//非 IE 直接讀 files[0].size
fileLenth = parseInt(obj.files[0].size);
} catch (e) {
flag = false;
return false;
}
}
//循環判斷圖片格式是否正確
for (var i in array) {
if (fileContentType.toLowerCase() == array[i].toLowerCase()) {
if (obj.files && obj.files[0]) {
//Firefox:直接把 File 物件轉成 blob URL
imgObjPreview.style.display = 'block';
imgObjPreview.style.width = '180px';
imgObjPreview.style.height = '200px';
imgObjPreview.src = window.URL.createObjectURL(obj.files[0]);
if (fileLenth > 102400) {
$.messager.alert("提示", "請選擇小於 100k 的圖片!");
flag = false;
return false;
}
} else {
//IE:使用 AlphaImageLoader 濾鏡
obj.select();
var imgSrc = document.selection.createRange().text;
localImagId.style.width = "180px";
localImagId.style.height = "200px";
//捕捉圖片異常,避免使用者竄改副檔名偽造圖片
try {
localImagId.style.filter = "progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale)";
localImagId.filters.item("DXImageTransform.Microsoft.AlphaImageLoader").src = imgSrc;
} catch (e) {
$.messager.alert("提示", "您上傳的圖片格式不正確,請重新選擇!");
flag = false;
return false;
}
imgObjPreview.style.display = 'none';
document.selection.empty();
}
isExists = true;
flag = true;
return true;
}
}
if (isExists == false) {
$.messager.alert("提示", "上傳圖片類型不正確!");
flag = false;
return false;
}
flag = false;
return false;
}
}
</script>
<tr class="detailInfo">
<td align="right">上傳照片:</td>
<td align="left">
<input type="file" id="idFile" name="idFile" width="150px" runat="server"
onchange="javascript:setImagePreview(this,localImag,preview);" />
</td>
</tr>
<tr class="detailInfo">
<td align="right">預覽:</td>
<td>
<div id="localImag">
<img id="preview" alt="預覽圖片" src="../img/userphoto.jpg" style="width: 150px; height: 170px;" />
</div>
</td>
</tr>
這段程式碼的價值不在於優雅,而在於它把「後端還沒收到檔案之前,前端就先把關」的思維講清楚了。實務上要留意兩點:一是 createObjectURL 產生的 blob 位址記得在不上傳時呼叫 revokeObjectURL 釋放;二是副檔名檢查只能擋住單純的誤選,真正的型別驗證仍應在伺服器端依 MIME 與檔案內容再判一次。
如果專案本來就引入了 KindEditor,其實不必自己造輪子。它的 image 外掛已經把「網路圖片 + 本地上傳」的整套互動做好了,只要呼叫 loadPlugin('image') 再走 imageDialog 即可。
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>ImageDialog Examples</title>
<link rel="stylesheet" href="../themes/default/default.css" />
<script src="../kindeditor.js"></script>
<script src="../lang/zh_CN.js"></script>
<script>
KindEditor.ready(function(K) {
var editor = K.editor({ allowFileManager : true });
//同時開放網路圖片與本地上傳
K('#image1').click(function() {
editor.loadPlugin('image', function() {
editor.plugin.imageDialog({
imageUrl : K('#url1').val(),
clickFn : function(url, title, width, height, border, align) {
K('#url1').val(url);
editor.hideDialog();
}
});
});
});
//只允許填網路圖片網址
K('#image2').click(function() {
editor.loadPlugin('image', function() {
editor.plugin.imageDialog({
showLocal : false,
imageUrl : K('#url2').val(),
clickFn : function(url, title, width, height, border, align) {
K('#url2').val(url);
editor.hideDialog();
}
});
});
});
//只允許本地上傳
K('#image3').click(function() {
editor.loadPlugin('image', function() {
editor.plugin.imageDialog({
showRemote : false,
imageUrl : K('#url3').val(),
clickFn : function(url, title, width, height, border, align) {
K('#url3').val(url);
editor.hideDialog();
}
});
});
});
});
</script>
</head>
<body>
<p><input type="text" id="url1" value="" />
<input type="button" id="image1" value="選擇圖片" />(網路圖片 + 本地上傳)</p>
<p><input type="text" id="url2" value="" />
<input type="button" id="image2" value="選擇圖片" />(網路圖片)</p>
<p><input type="text" id="url3" value="" />
<input type="button" id="image3" value="選擇圖片" />(本地上傳)</p>
</body>
</html>
三個按鈕分別對應三種開放策略,靠的是 showLocal 與 showRemote 兩個開關。想知道更多細節,可以直接打開 image.js 搜尋 imageDialog,裡頭的實作與上面這段呼叫幾乎一一對應。真正負責收檔的 upload_json.jsp 只要把 url、title、width、height、order、align 這些欄位回傳,前端就能立刻拿到可用的圖片資訊。
兩種方案各有適用場景:追求完全掌控就手寫,追求交付速度就用外掛。以上就是 JavaScript 實作圖片上傳前台頁面的完整思路。