DIV CSS 佈局教程網

Summernote 圖片上傳功能實作思路
編輯:關於JavaScript     

做 Bootstrap 網頁時需要一個富文本編輯器,隨手挑了 Summernote,卻發現圖片上傳怎麼試都沒反應。翻過官方文件之後才找到正解,這裡把過程整理下來。

問題出在哪裡

官方文件其實有寫,但接口寫法改過版,網路上流通的教學多半是舊版寫法,照抄自然全軍覆沒。這部分我 search 得也不夠深入,得承認。

官方提供的兩個核心 API

接管圖片上傳事件:

// 接管圖片上傳事件
$('#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 文件,這也是最多人踩的坑。

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