傳統的檔案上傳流程是:選檔 → 送出 → 等伺服器回應 → 才能看到圖片。HTML5 的 FileReader 讓預覽完全在瀏覽器端完成,選完立刻顯示,體驗差很多。本文示範 IE9 以上的實作版本。
FileReader 把本機檔案讀成 DataURL(data:image/png;base64,... 這種字串),而這個字串可以直接當成 <img> 的 src 使用。整個預覽因此不需要任何伺服器往返。
需要说明的是,IE8 以下的做法完全不同——那個年代只能靠 filter: progid:DXImageTransform.Microsoft.AlphaImageLoader 這種私有濾鏡。因為專案只要求 IE9 以上,這裡不談舊方案。
#kk {
width: 400px;
height: 400px;
overflow: hidden;
}
#preview_wrapper {
width: 300px;
height: 300px;
background-color: #CCC;
overflow: hidden;
}
#preview_fake { /* 在 IE 下顯示預覽圖片用 */
filter: progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale);
width: 300px;
overflow: hidden;
}
#preview_size_fake { /* 只用來取得圖片原始尺寸 */
filter: progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=image);
width: 300px;
visibility: hidden;
overflow: hidden;
}
#preview { /* 在 Firefox / Chrome 下顯示預覽用 */
width: 300px;
height: 300px;
overflow: hidden;
}
<input name="localfile" type="file" id="localfile" size="28"
onchange="onUploadImgChange(this)" />
<!-- 以下是預覽圖片用的 -->
<div id="kk">
<div id="preview_wrapper">
<div id="preview_fake">
<img id="preview" src="" onload="onPreviewLoad(this)" />
</div>
</div>
<br/>
<img id="preview_size_fake" />
</div>
function onUploadImgChange(sender) {
if (!sender.value.match(/\.jpg|gif|png|bmp/i)) {
alert('圖片格式無效!');
return false;
}
var objPreview = document.getElementById('preview');
var objPreviewFake = document.getElementById('preview_fake');
var objPreviewSizeFake = document.getElementById('preview_size_fake');
if (sender.files && sender.files[0]) {
// 現代瀏覽器走這裡
objPreview.style.display = 'block';
objPreview.style.width = 'auto';
objPreview.style.height = 'auto';
objPreview.src = URL.createObjectURL(sender.files[0]);
} else if (objPreviewFake.filters) {
// IE7 / IE8 舊方案:只能用濾鏡
sender.select();
sender.blur();
var imgSrc = document.selection.createRange().text;
objPreviewFake.filters.item(
'DXImageTransform.Microsoft.AlphaImageLoader').src = imgSrc;
objPreviewSizeFake.filters.item(
'DXImageTransform.Microsoft.AlphaImageLoader').src = imgSrc;
autoSizePreview(objPreviewFake,
objPreviewSizeFake.offsetWidth,
objPreviewSizeFake.offsetHeight);
objPreview.style.display = 'none';
}
}
這裡有個重點:原範例使用 sender.files[0].getAsDataURL(),那是早期 Firefox 的私有方法,現在已經移除。標準做法是 URL.createObjectURL(file),若要真的取得 DataURL 字串,就改用 FileReader:
var reader = new FileReader();
reader.onload = function (e) {
document.getElementById('preview').src = e.target.result;
};
reader.readAsDataURL(sender.files[0]);
用完 createObjectURL 產生的 blob URL 記得在不再需要時呼叫 URL.revokeObjectURL(url) 釋放,否則連續選圖會累積記憶體。
圖片尺寸千變萬化,要放進固定的 300×300 框內又不變形,就是最經典的「長邊對齊」問題:找出寬、高各自的縮放比例,取較大的那個當分母(也就是縮得更多的),再同時套用。
function clacImgZoomParam(maxWidth, maxHeight, width, height) {
var param = { width: width, height: height, top: 0, left: 0 };
if (width > maxWidth || height > maxHeight) {
var rateWidth = width / maxWidth;
var rateHeight = height / maxHeight;
if (rateWidth > rateHeight) {
param.width = maxWidth;
param.height = height / rateWidth;
} else {
param.width = width / rateHeight;
param.height = maxHeight;
}
}
param.left = (maxWidth - param.width) / 2;
param.top = (maxHeight - param.height) / 2;
return param;
}
function autoSizePreview(objPre, originalWidth, originalHeight) {
var zoomParam = clacImgZoomParam(300, 300, originalWidth, originalHeight);
objPre.style.width = zoomParam.width + 'px';
objPre.style.height = zoomParam.height + 'px';
objPre.style.marginTop = zoomParam.top + 'px';
objPre.style.marginLeft = zoomParam.left + 'px';
}
function onPreviewLoad(sender) {
autoSizePreview(sender, sender.offsetWidth, sender.offsetHeight);
}
marginTop 與 marginLeft 是負值時會產生置中效果——這正是把圖片在容器裡水平垂直居中的手法。
檔案大小檢查。預覽再快,也不代表該讓使用者選一張 20MB 的照片進來。建議在讀檔前先擋:
var MAX = 5 * 1024 * 1024;
if (sender.files[0].size > MAX) {
alert('圖片不可超過 5MB');
return false;
}
用 CSS 簡化置中。上面那套 margin 計算在今天已經不必要了,改用 object-fit 一行解決:
#preview {
width: 100%;
height: 100%;
object-fit: contain; /* 等比例縮放並置中 */
}
這樣連 onload 裡的尺寸計算都可以省下來,程式碼少一半。