DIV CSS 佈局教程網

Bootstrap 智能表單實戰:圖片上傳與即時預覽
編輯:關於JavaScript     

表單裡的圖片上傳看似小事,實作起來卻常卡在「上傳完怎麼預覽」與「表單送出時怎麼帶路徑」這兩個環節。本文說明一套「先傳後填」的做法。

核心機制

整體流程是這樣的:使用者選檔 → 立即上傳到伺服器 → 伺服器回傳圖片的存放路徑 → 前端把路徑寫進隱藏欄位並顯示預覽圖 → 表單送出時,隨其他欄位一起把路徑送到後端儲存。

這個設計有個重要好處:圖片上傳與表單儲存解耦。使用者可以在填表過程中反覆換圖,只有最後選定的那張路徑會被存進資料庫,不會產生一堆孤兒檔案以外的關聯問題(孤兒檔案仍需另一套清理機制處理)。

依賴與呼叫

頁面原始碼:https://github.com/xiexingen/Bootstrap-SmartForm/blob/master/demo/form3-ele-img.html

依賴 jquery-file-upload 插件,需引入:

  • jquery.ui.widget.js
  • jquery.iframe-transport.js
  • jquery.fileupload.js

呼叫方式:

global.Fn.InitPlugin('img', 'formContainer');
// 第二個參數為表單 id,用於縮小查找範圍,可省略

參數說明

  • id:自訂識別名稱,主要用來區分多個上傳欄位。
  • multiple:'true' 表示允許多選。
  • name:上傳請求中檔案欄位的鍵名,需與後端接收端點一致。
  • handle:single 表示新圖會取代舊圖,其他值則是追加在既有圖片之後。
  • url:上傳的提交位址,也可改 global.js 中 global.Fn.InitUploadImage 的預設值。
  • extendAttr:掛到欄位上的自訂屬性對。

後端回應格式約定

插件預期的 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) 釋放記憶體
});

方法一(先傳)的好處是使用者送表單前就知道上傳是否成功;方法二(延遲傳)則節省流量——使用者選了又改主意時不必真的傳。表單有多張圖時,方法二的優勢更明顯。

服務端必做的檢查

  • 副檔名白名單,並比對實際檔案內容的 magic number,不能只看檔名。
  • 限制檔案大小,同時在 web.config / nginx.conf 調整請求上限,否則大檔會在進入應用程式前就被拒絕。
  • 重新產生檔名(時間戳或 UUID),切勿沿用使用者上傳的原始檔名,避免路徑穿越與覆蓋攻擊。
  • 儲存目錄不可執行,並確認上傳後的檔案無法被當成腳本執行。
  • 加上登入驗證與請求頻率限制。

把「上傳 → 回傳路徑 → 存進隱藏欄位 → 隨表單提交」這條鏈路打通之後,圖片欄位就跟其他文字欄位一樣好用了。剩下的功夫多半在服務端的安全與檔案清理機制上,那部分值得另外專文討論。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved