本文將淺析線上所見即所得(WYSIWYG)HTML 編輯器的實作原理,透過初始化、開啟編輯功能、取得內容、增加樣式設定等步驟,說明其基本實現方式。
如今網站開發越來越重視使用者體驗,線上 HTML 編輯器算是其中較「古老」的一類。功能簡單的可提供文字樣式控制,複雜的甚至能媲美 Word。市面上開源編輯器雖多,但真正好用的並不多。若不需要太強大的功能,其實可以自己實作一個,因為程式碼並不複雜。以下以 ExtJS 的 HTMLEditor 為例說明。
頁面加載完畢後,向頁面加入一個 IFrame(可選)。此處要注意判斷頁面狀態,等頁面完全加載完畢後再操作,避免找不到某些元素而報錯。
將 IFrame 設為可編輯,關鍵是取得 iframe 的 window 與 document 物件,並將 designMode 設為 "on":
getWin : function(){ return Ext.isIE ? this.iframe.contentWindow : window.frames[this.iframe.name];},getDoc : function(){ return Ext.isIE ? this.getWin().document : (this.iframe.contentDocument || this.getWin().document);},doc = this.getDoc();doc.open();doc.write('...');doc.designMode = "on";doc.close();
var body = doc.body || doc.documentElement;var content = body.innerHTML;//對內容進行處理return content;
document 的 execCommand 方法使樣式設定成為可能:
function execCmd(cmd, value){ doc.execCommand(cmd, false, value === undefined ? null : value);};execCmd('bold'); //Ctrl-BexecCmd('underline'); //Ctrl-UexecCmd('italic'); //Ctrl-IexecCmd('forecolor', '#'+color);
若編輯器有工具欄,我們還希望按鈕能依滑鼠所在位置的樣式自動切換狀態。document 的 queryCommandState() 方法讓這成為可能:
var isBold = doc.queryCommandState('bold');if(isBold){ /* 改變 Bold 按鈕樣式 */ }doc.queryCommandState('underline');doc.queryCommandState('italic');
本文只提供了實作編輯器的簡單思路,其中部分程式碼可直接使用。想自行實作的朋友可參考 ExtJS 的 HTMLEditor 程式碼,既簡單又清晰。最後提醒:一定要注意瀏覽器相容性問題,並及早測試,否則大量 JavaScript 程式碼在收尾階段才調整會相當痛苦。