KindEditor 是一款功能完整的開源所見即所得 HTML 編輯器,以 JavaScript 撰寫,能與 .NET、PHP、ASP、Java 等多種後端環境整合。官網:https://kindeditor.net/index.php
由於原始碼開放,開發者可以自由擴充。本文要解決的是一個非常實際的痛點。
編輯人員撰寫內容時,往往不是從空白開始,而是從其他網頁或 Word 檔複製貼上。若複製內容裡含有圖片,這些圖片的 src 仍然指向來源網站。一旦來源網站關閉或防盗鏈生效,你網站上的圖片也跟著失效。所以必須把圖片下載回自己的伺服器。
如果每張圖都要手動另存再上傳,處理幾十份文件時簡直是惡夢。目標 therefore 很明確:讓編輯器自動辨識貼上的內容,找出遠程圖片並一鍵上傳。
(註:此方案無法處理從 Word 直接貼上的內嵌圖片,那類圖片在你的瀏覽器剪貼板上並無有效 URL。)
keyup 事件中檢查內容裡是否有 img 元素。src 以 https:// 或 https:// 開頭的遠程圖片。src 改寫為本地路徑。關於 KindEditor 的基本用法請參考官方文件,此處不再重複。
找到 kindeditor.js,在 keyup() 事件中加入自訂呼叫。不同版本的程式碼差異較大,需對照官方文件查找;本文基於 4.1.10 版。

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 會導致編輯畫面變了、實際儲存內容卻沒變。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。WebClient 預設超時很長,建議改用 HttpClient 並設定合理逾時。把這些補齊之後,這個功能能為編輯流程省下大量重複勞動,是很值得投入的基礎建設。