做 Bootstrap 網頁時需要一個富文本編輯器,隨手挑了 Summernote,卻發現圖片上傳怎麼試都沒反應。翻過官方文件之後才找到正解,這裡把過程整理下來。
官方文件其實有寫,但接口寫法改過版,網路上流通的教學多半是舊版寫法,照抄自然全軍覆沒。這部分我 search 得也不夠深入,得承認。
接管圖片上傳事件:
// 接管圖片上傳事件
$('#summernote').summernote({
callbacks: {
onImageUpload: function (files) {
// 上傳圖片到伺服器,再把圖片插入編輯框
}
}
});
插入圖片:
$('#summernote').summernote('insertImage', url, filename);
更詳細的參數說明請見官方 API 文件。
後端部分這裡不展開——網路上到處都有,這裡假設後端收到檔案後會回傳可存取的路徑。
$('#summernote').summernote({
callbacks: {
onImageUpload: function (files) {
// 使用 FormData 物件上傳
// 相容性方面,據說對舊版 IE 不太友善
var formData = new FormData();
formData.append('file', files[0]);
$.ajax({
url: 'upload', // 後端的檔案上傳端點
type: 'POST',
data: formData,
processData: false, // 不讓 jQuery 加工資料
contentType: false, // 不讓 jQuery 設定 Content-Type
success: function (data) {
$('#summernote').summernote('insertImage', data, 'img');
}
});
}
}
});
上面只示範了最基礎的成功路徑,還有幾件事在正式環境一定要補:
錯誤處理:上傳失敗時使用者完全沒有回饋。至少要加上 error 回呼與載入中的提示。
檔案驗證:前端檢查副檔名只能擋住誤操作,真正的型別與大小限制必須在後端做。
insertImage 的第二個參數:不同版本的 Summernote 對 insertImage 的簽名有差異,有的接受 url,有的要 url 加檔名。若呼叫後沒反應,先確認你所用版本的 API 文件,這也是最多人踩的坑。