###基礎API 以下是二次開發過程中，比較常用的對象API ----- - **`editor.ready`** 當編輯器加載、準備完畢之后，會調用傳入的函數，例如： ```js editor.ready(function () { // 這里的 this 指向編輯器對象本身 var editor = this; editor.$txt.append('<p>編輯器已經準備完成</p>'); }); ``` ----- - **`editor.updateValue`** 如果你使用了`textarea`創建編輯器，改方法可將編輯器區域的內容，同步到`textarea`中。例如： ```js $('#someBtn').click(function () { editor.$txt.append('追加了新內容'); editor.updateValue(); // 及時更新到 textarea 中 }); ``` ----- - **`editor.disableMenusExcept`** 如果不傳入任何參數，將禁用所有菜單。如果傳入某一個或某幾個菜單的id，將禁用其他菜單。參數可以是`字符串`或`數組`。**所有菜單的id，可參考『參數配置-自定義菜單』小節**。例如： ```js $('#someBtn').click(function () { editor.disableMenusExcept(); //禁用所有菜單 editor.disableMenusExcept('bold'); //禁用所有菜單，除了『粗體』菜單 editor.disableMenusExcept(['bold', 'img']); //禁用所有菜單，除了『粗體』和『圖片』菜單 }); ``` ----- - **`editor.enableMenusExcept`** 和`editor.disableMenusExcept`的應用相同，只不過作用想法。這個API是啟用菜單的。 ----- - **`editor.disable` `editor.enable`** 參見『內容管理 - 啟用/禁用』小節 ----- - **`editor.create`** 創建一個編輯器，即文檔『開始使用 - 生成編輯器』一節描述的用法。 ----- - **`editor.getLegalTags`** 根據一個`elem`元素，查找父元素，直到獲取編輯器允許的`合法類型的元素`位置，并返回該父元素。例如： ```js $('#btn').click(function () { // 獲取當前選區所在的元素 var elem = editor.getRangeElem(); // 獲取當前選區所在的合法類型的元素 var legalElem = editor.getLegalTags(elem); }); ``` **說明：**所謂『合法類型的元素』是指編輯器允許在編輯器區域內出現的頂級節點的元素類型。 例如，通常情況下，允許`<p>`作為頂級節點，而不允許`<div>`作為頂級節點。因為`<div>`作為頂級節點時，回車換行會出現問題。 這些合法標簽，可通過 `wangEditor.config.legalTags` 獲取和配置。 ``` // 首先確保引用了 wangEditor.min.js console.log(wangEditor.config.legalTags); ``` ---- - **`editor.getSelfOrParentByName`** 傳入一個elem元素和一個查詢條件，查詢符合條件的父元素、或該元素本身。 ```js $('#btn').click(function () { // 獲取當前選區所在的元素 var elem = editor.getRangeElem(); // 獲取當前選區所在的 p 元素 var p = editor.getSelfOrParentByName(elem, 'p'); }); ```