DIV CSS 佈局教程網

KindEditor 自動上傳貼上內容中的遠程圖片
編輯:關於JavaScript     

KindEditor 是一款功能完整的開源所見即所得 HTML 編輯器,以 JavaScript 撰寫,能與 .NET、PHP、ASP、Java 等多種後端環境整合。官網:https://kindeditor.net/index.php

由於原始碼開放,開發者可以自由擴充。本文要解決的是一個非常實際的痛點。

問題場景

編輯人員撰寫內容時,往往不是從空白開始,而是從其他網頁或 Word 檔複製貼上。若複製內容裡含有圖片,這些圖片的 src 仍然指向來源網站。一旦來源網站關閉或防盗鏈生效,你網站上的圖片也跟著失效。所以必須把圖片下載回自己的伺服器。

如果每張圖都要手動另存再上傳,處理幾十份文件時簡直是惡夢。目標 therefore 很明確:讓編輯器自動辨識貼上的內容,找出遠程圖片並一鍵上傳。

(註:此方案無法處理從 Word 直接貼上的內嵌圖片,那類圖片在你的瀏覽器剪貼板上並無有效 URL。)

實作思路

  1. 在編輯器的 keyup 事件中檢查內容裡是否有 img 元素。
  2. 過濾出 src 以 https:// 或 https:// 開頭的遠程圖片。
  3. 若有,在工具列下方顯示提示條與「上傳」連結。
  4. 點擊上傳後以 Ajax 呼叫後端,把圖片清單送過去。
  5. 後端下載圖片存檔,回傳新的相對路徑清單。
  6. 前端在回呼中把各圖片的 src 改寫為本地路徑。

關於 KindEditor 的基本用法請參考官方文件,此處不再重複。

步驟一:修改 kindeditor.js

找到 kindeditor.js,在 keyup() 事件中加入自訂呼叫。不同版本的程式碼差異較大,需對照官方文件查找;本文基於 4.1.10 版。

步驟二:auto.js

function df() {
  // 建立提示條(只需建立一次)
  var haspicContainer = document.getElementById("has_pic");
  if (haspicContainer == null) {
    haspicContainer = document.createElement("div");
    haspicContainer.id = "has_pic";
    haspicContainer.innerHTML =
      "<input type='text' id='piclist' value='' style='display:none;'/>" +
      "<div id='upload'><b>您有圖片需要上傳到服務器</b>  " +
      "<a href='javascript:uploadpic();'>上傳</a></div>" +
      "<div id='confirm'></div>";
    $(".ke-toolbar").after(haspicContainer);
  }

  // 編輯器內容存放在 iframe 中,class 為 ke-edit-iframe
  var img = $(".ke-edit-iframe").contents().find("img");
  var piccount = 0;
  var sstr = "";

  $(img).each(function (i) {
    var that = $(this);
    var src = that.attr("src") || "";
    // 只收集遠程圖片
    if (src.indexOf("https://") >= 0 || src.indexOf("https://") >= 0) {
      piccount++;
      sstr += (i == $(img).length - 1) ? src : src + "|";
    }
  });

  $("#piclist").val(sstr);
  document.getElementById("has_pic").style.display =
    (piccount > 0) ? "block" : "none";
}

function closeupload() {
  $("#has_pic").hide();
  $("#upload").show();
}

function uploadpic() {
  var piclist = encodeURI($("#piclist").val());
  if (piclist.length == 0) return false;

  $.ajax({
    url: "uploadpic.ashx",
    data: "pic=" + piclist,
    type: "GET",
    beforeSend: function () {
      $("#upload").hide();
      $("#confirm").text("正在上傳中...");
    },
    success: function (msg) {
      if (msg !== "") {
        var str = msg.split('|');
        var img = $(".ke-edit-iframe").contents().find("img");
        var index = 0;
        $(img).each(function () {
          var that = $(this);
          var src = that.attr("src") || "";
          if (src.indexOf("https://") >= 0 || src.indexOf("https://") >= 0) {
            var newSrc = "/uploads/image/" + str[index++];
            that.attr("src", newSrc);
            // data-ke-src 是 KindEditor 用於還原內容的隱藏屬性,必須同步更新
            that.attr("data-ke-src", newSrc);
          }
        });
        $("#confirm").html(
          str.length + " 張圖片已經上傳成功!  " +
          "<a href='javascript:closeupload();'>關閉</a>"
        );
      } else {
        $("#confirm").text("上傳失敗!");
      }
    }
  });
}

幾個關鍵點:

  • $(".ke-edit-iframe").contents().find("img") 是取得編輯器內所有圖片的方法,因為內容被包在 iframe 裡,必須用 contents() 穿透。
  • 判斷 src 是否含 https:// 或 https:// 來區分遠程與本地圖片。更嚴謹的做法是比對是否以本站網域開頭。
  • data-ke-src 必須一起改。KindEditor 在輸出內容時優先採用這個屬性,只改 src 會導致編輯畫面變了、實際儲存內容卻沒變。

步驟三:uploadpic.ashx(C# 後端)

public class uploadpic : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        context.Response.ContentType = "text/plain";
        string pic = context.Request.QueryString["pic"];
        string[] arr = pic.Split('|');
        string sstr = "";
        UpLoadIMG st = new UpLoadIMG();

        for (int i = 0; i < arr.Length; i++)
        {
            if (arr[i].IndexOf("https://") >= 0 || arr[i].IndexOf("https://") >= 0)
            {
                string std = st.SaveUrlPics(arr[i], "../../uploads/image/");
                if (std.Length > 0)
                {
                    sstr += (i == arr.Length - 1) ? std : std + "|";
                }
            }
        }
        context.Response.Write(sstr);
    }

    public bool IsReusable { get { return false; } }
}

public class UpLoadIMG
{
    public string SaveUrlPics(string imgurlAry, string path)
    {
        string strHTML = "";
        string dirPath = HttpContext.Current.Server.MapPath(path);
        try
        {
            if (!Directory.Exists(dirPath))
                Directory.CreateDirectory(dirPath);

            // 依日期建子目錄,避免單一目錄檔案過多
            string ymd = DateTime.Now.ToString("yyyyMMdd", DateTimeFormatInfo.InvariantInfo);
            dirPath += ymd + "/";
            if (!Directory.Exists(dirPath))
                Directory.CreateDirectory(dirPath);

            // 檔名用時間戳,保留原副檔名
            string ext = imgurlAry.Substring(imgurlAry.LastIndexOf("."));
            string newFileName = DateTime.Now.ToString("yyyyMMddHHmmss_ffff",
                                 DateTimeFormatInfo.InvariantInfo) + ext;

            WebClient wc = new WebClient();
            wc.DownloadFile(imgurlAry, dirPath + newFileName);
            strHTML = ymd + "/" + newFileName;
        }
        catch (Exception)
        {
            // 單張失敗不影響其他圖片
        }
        return strHTML;
    }
}

後端用 WebClient.DownloadFile 把遠程圖片存到 /uploads/image/,並依日期自動建子目錄、以時間戳命名避免覆蓋。回傳結果以 | 分隔各圖片的相對路徑,前端在 success 回呼中解析並寫回 src。

上生產前必須補的安全措施

原始範例為了簡潔省略了幾項防護,實際上線前一定要補:

  • 圖片格式白名單:只允許 .jpg/.png/.gif/.webp,副檔名過濾要同時檢查檔名與實際內容的 magic number。
  • 來源網域白名單:避免變成任意 URL 抓取器,被拿來探測內網或做 SSRF 攻擊。
  • 大小限制:限制單檔大小與總下載量,否則一張巨型圖就能拖垮伺服器。
  • 超時控制:WebClient 預設超時很長,建議改用 HttpClient 並設定合理逾時。
  • 登入驗證:上傳端點必須確認調用者有編輯權限。

把這些補齊之後,這個功能能為編輯流程省下大量重複勞動,是很值得投入的基礎建設。

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