所見即所得(WYSIWYG)編輯器核心利用 iframe 的 designMode="on" 或 contentEditable。本文以 ExtJS HTMLEditor 為例,拆解初始化、編輯啟用、內容獲取、命令執行、工具欄狀態同步五大步驟。
頁面載入完成後動態插入 <iframe>,等待 onload 確保文檔就緒。
var doc = iframe.contentDocument || iframe.contentWindow.document;
doc.open();
doc.write('<html><head><style>body{margin:0;padding:3px;height:98%;cursor:text;}</style></head><body></body></html>');
doc.designMode = "on"; // 關鍵:啟用編輯
doc.close();
designMode="on" 使整個文檔可編輯;現代也可用 body.contentEditable="true"。
var body = doc.body || doc.documentElement;
var html = body.innerHTML;
// 後處理:清理無效標籤、統一風格、過濾 XSS
return html;
function execCmd(cmd, value) {
doc.execCommand(cmd, false, value === undefined ? null : value);
}
// 常用命令
execCmd('bold'); // 加粗
execCmd('forecolor', '#f00'); // 字體顏色
execCmd('InsertHTML', '<img src="...">'); // 插入內容
execCommand 覆蓋所有基本排版需求,但各瀏覽器實現細節差異大(如插入圖片、清理 Word 粘貼)。
var isBold = doc.queryCommandState('bold'); // true/false
if (isBold) toolbar.boldBtn.addClass('pressed');
queryCommandState 返回光標處格式狀態,據此高亮工具按鈕。
iframe.contentWindow.document,FF/Chrome 用 contentDocument。execCommand 參數大小寫不敏感,但值格式有差異(顏色值 #RRGGBB vs rgb())。Selection/Range) 差異極大,複雜操作建議用成熟庫(CKEditor、TinyMCE、Quill、Slate)。理解核心原理,有助於二次開發或排查疑難雜症。