表單裡的圖片上傳看似小事,實作起來卻常卡在「上傳完怎麼預覽」與「表單送出時怎麼帶路徑」這兩個環節。本文說明一套「先傳後填」的做法。
整體流程是這樣的:使用者選檔 → 立即上傳到伺服器 → 伺服器回傳圖片的存放路徑 → 前端把路徑寫進隱藏欄位並顯示預覽圖 → 表單送出時,隨其他欄位一起把路徑送到後端儲存。
這個設計有個重要好處:圖片上傳與表單儲存解耦。使用者可以在填表過程中反覆換圖,只有最後選定的那張路徑會被存進資料庫,不會產生一堆孤兒檔案以外的關聯問題(孤兒檔案仍需另一套清理機制處理)。
頁面原始碼:https://github.com/xiexingen/Bootstrap-SmartForm/blob/master/demo/form3-ele-img.html
依賴 jquery-file-upload 插件,需引入:
jquery.ui.widget.jsjquery.iframe-transport.jsjquery.fileupload.js呼叫方式:
global.Fn.InitPlugin('img', 'formContainer');
// 第二個參數為表單 id,用於縮小查找範圍,可省略
'true' 表示允許多選。single 表示新圖會取代舊圖,其他值則是追加在既有圖片之後。global.js 中 global.Fn.InitUploadImage 的預設值。插件預期的 JSON 格式為:
{ result: 200, imgurl: '...' }
result: 200 代表上傳成功,imgurl 是可供前端存進隱藏欄位的相對路徑。這個約定很重要——前端與後端必須對此達成一致,否則預覽不會出現。
若自行實作而非使用插件,預覽的關鍵在 FileReader 或 URL.createObjectURL:
// 方法一:上傳完成後用回傳的伺服器路徑
input.addEventListener('change', function () {
var file = this.files[0];
var formData = new FormData();
formData.append('file', file);
fetch('/upload', { method: 'POST', body: formData })
.then(function (r) { return r.json(); })
.then(function (res) {
if (res.result === 200) {
$('#preview').attr('src', res.imgurl);
$('#hiddenImgPath').val(res.imgurl); // 表單送出時帶走
}
});
});
// 方法二:選檔後先本地預覽,送出時才上傳
input.addEventListener('change', function () {
var file = this.files[0];
if (!file) return;
var url = URL.createObjectURL(file);
$('#preview').attr('src', url);
// 記得在不再需要時呼叫 URL.revokeObjectURL(url) 釋放記憶體
});
方法一(先傳)的好處是使用者送表單前就知道上傳是否成功;方法二(延遲傳)則節省流量——使用者選了又改主意時不必真的傳。表單有多張圖時,方法二的優勢更明顯。
web.config / nginx.conf 調整請求上限,否則大檔會在進入應用程式前就被拒絕。
把「上傳 → 回傳路徑 → 存進隱藏欄位 → 隨表單提交」這條鏈路打通之後,圖片欄位就跟其他文字欄位一樣好用了。剩下的功夫多半在服務端的安全與檔案清理機制上,那部分值得另外專文討論。