「上傳圖片後立刻看到預覽」是很常見的功能。以往多靠 Flash 搭配 JavaScript 實作,若同事不想引入 Flash、也不想用現成套件,iframe 是一個簡單可行的替代方案。
・把上傳圖片的區塊放進一個 iframe,設定無邊框、無捲軸,風格與外層頁面一致,尺寸依需要固定。
・在 iframe 內送出表單,送出後再次載入原頁面(也就是 iframe 指向的頁面),並由伺服器帶回剛上傳的圖片路徑,接著呼叫父頁面的 JavaScript 來載入圖片。
・若需要進度條等效果,可在表單送出後由伺服器端持續輸出進度並推送 JavaScript 呼叫,即時更新頁面內容;取消等其他功能也可參照同樣的推送機制處理。
頁面中嵌入一個檔案上傳頁 _uploadpic.jsp:
...
<script type="text/javascript">
/*
* param imgPath:已上傳圖片的路徑
* 此函式會把圖片顯示在 id 為 show_img_div 的區塊中
*/
function showUploadImg(imgPath) {
if (imgPath == "") return;
document.getElementById("show_img_div").innerHTML = "<img src='" + imgPath + "'/>";
}
</script>
<body>
<iframe scrolling="no" width="300" height="100" src="_uploadpic.jsp"></iframe>
<!-- 用來顯示已上傳的圖片 -->
<div id="show_img_div"></div>
...
...
<body onload="javascript:window.parent.showUploadImg('${img}');">
<!-- ${img} 為伺服器傳來的圖片路徑 -->
<form method="post" id="upload_form"
action="${pageContext.request.contextPath}/servlet/IframeTestImageServlet"
enctype="multipart/form-data">
<input type="file" name="pic"/><br/>
<input type="submit" value="upload"/>
</form>
</body>
...
關鍵在 onload:iframe 內的頁面載入完成後,透過 window.parent 呼叫父頁面的函式,把圖片路徑傳回去。因為兩者同網域,這種跨框架呼叫是被允許的。
// 處理上傳的圖片
// ... 此處省略檔案處理程式碼 ...
// 把剛上傳圖片在伺服器上的路徑回傳給客戶端
request.setAttribute("img", request.getContextPath() + "/img/mm.jpg");
request.getRequestDispatcher("/_uploadpic.jsp").forward(request, response);
・以 innerHTML 插入 img 標籤時,若路徑可能包含使用者的輸入,須先轉義,否則會有 XSS 風險;更穩妥的作法是建立 img 元素後設定其 src 屬性。
・iframe 的 src 指向同一網域是這個方案的前提。若圖片上傳到另一個網域,window.parent 的呼叫會被同源政策擋下。
・伺服器端務必驗證上傳的檔案型別與大小,並重新命名儲存檔案,不要直接使用使用者提供的檔名。
這套 iframe 技巧在今日已有更簡潔的取代方案:用 <input type="file" accept="image/*"> 選檔後,直接以 URL.createObjectURL 在頁面中產生暫存網址預覽,完全不需要上傳就能預覽:
document.querySelector('input[type=file]').addEventListener('change', function (e) {
var file = e.target.files[0];
if (!file) return;
var img = document.createElement('img');
img.src = URL.createObjectURL(file); // 產生本機暫存網址
document.getElementById('show_img_div').appendChild(img);
// 釋放後可呼叫 URL.revokeObjectURL(img.src) 回收記憶體
});
搭配 File API 與 Canvas,還能在前端先裁切、縮圖、壓縮再上傳,大幅節省頻寬。若需要真正的上傳進度,則用 XMLHttpRequest 的 upload.onprogress 即可,不必再依賴伺服器推送腳本這種老技巧。