使用百度 UEditor 時常會遇到一個困擾:從別的網站複製內文貼進編輯器,只要裡面有非本站網域的圖片,UEditor 就會自動發請求把它們抓回自己的伺服器。這個行為在某些場景下很不合時宜,而官方文件裡居然找不到開關。本文記錄一次翻原始碼找到答案的過程。
一開始完全找不到觸發方式,還以為有個按鈕可以手動啟動,翻完文件也沒結論。後來才發現:只要貼上含有非白名單網域圖片的內容,它就自動作動了。知道觸發條件之後,要找的就是「如何讓它不要作動」。
官方文件與論壇都沒有著落,只好直接翻 ueditor.all.js。搜尋後在 plugins/catchremoteimage.js 這段找到線索:
// plugins/catchremoteimage.js
///import core
///commands 遠程圖片抓取
///commandsName catchRemoteImage,catchremoteimageenable
///commandsTitle 遠程圖片抓取
/**
* 遠程圖片抓取, 當開啟本插件時所有不符合本地域名的圖片都將被抓取成為本地服務器上的圖片
*/
UE.plugins['catchremoteimage'] = function () {
var me = this,
ajax = UE.ajax;
/* 設置默認值 */
if (me.options.catchRemoteImageEnable === false) return;
me.setOpt({
catchRemoteImageEnable: false
});
// .......
};
關鍵就在第二行的判斷:`if (me.options.catchRemoteImageEnable === false) return;`。也就是說外掛在啟動時會先檢查這個設定,只要它是 false 就直接返回、完全不掛載後續邏輯。而設定檔裡並沒有預先寫入這個參數,所以預設情況下外掛一律啟動。
打開 ueditor.config.js,加上一行:
// 抓取遠程圖片是否開啟,默認 true
,catchRemoteImageEnable:false
存檔後重新整理編輯器頁面,再複製貼上含有遠程圖片的內容,這次就不會再向伺服器發出 catchimage 的 get 請求了。
這個案例說明一件事:當官方文件查不到某個行為的開關時,直接讀原始碼往往比繼續翻文件更快。UEditor 的外掛結構其實相當規律,每個外掛開頭都會檢查對應的 options 判斷是否要跳過初始化,只要養成搜尋 `me.options.` 的習慣,大多數「莫名其妙的功能」都能找到對應的開關。
另外提醒一點:如果日後確實需要這個功能,只要把值改回 true 或移除該行即可,不必更動程式碼本體,升級時也不容易出問題。