萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

在線富文本編輯器實現原理淺析:基於 iframe designMode

所見即所得(WYSIWYG)編輯器核心利用 iframe 的 designMode="on" 或 contentEditable。本文以 ExtJS HTMLEditor 為例,拆解初始化、編輯啟用、內容獲取、命令執行、工具欄狀態同步五大步驟。

1. 初始化:創建 iframe

頁面載入完成後動態插入 <iframe>,等待 onload 確保文檔就緒。

2. 開啟編輯模式

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"。

3. 獲取編輯器內容

var body = doc.body || doc.documentElement;
var html = body.innerHTML;
// 後處理:清理無效標籤、統一風格、過濾 XSS
return html;

4. 執行格式命令

function execCmd(cmd, value) {
    doc.execCommand(cmd, false, value === undefined ? null : value);
}
// 常用命令
execCmd('bold');           // 加粗
execCmd('forecolor', '#f00'); // 字體顏色
execCmd('InsertHTML', '<img src="...">'); // 插入內容

execCommand 覆蓋所有基本排版需求,但各瀏覽器實現細節差異大(如插入圖片、清理 Word 粘貼)。

5. 工具欄狀態同步

var isBold = doc.queryCommandState('bold'); // true/false
if (isBold) toolbar.boldBtn.addClass('pressed');

queryCommandState 返回光標處格式狀態,據此高亮工具按鈕。

兼容性填坑指南

  • IE 需 iframe.contentWindow.document,FF/Chrome 用 contentDocument。
  • execCommand 參數大小寫不敏感,但值格式有差異(顏色值 #RRGGBB vs rgb())。
  • 選區/範圍 API (Selection/Range) 差異極大,複雜操作建議用成熟庫(CKEditor、TinyMCE、Quill、Slate)。
  • 務必早期多瀏覽器測試,調試編輯器極其痛苦。

理解核心原理,有助於二次開發或排查疑難雜症。

copyright © 萬盛學電腦網 all rights reserved