KindEditor-編輯器配置參數屬性

在《KindEditor-KindEditor簡介》中提到了KindEditor編輯器的使用方法，下面是一段源碼：

function editText(){

KindEditor.ready(function(K) {

editor1 = K.create('textarea[id="contentEdit"]', {

cssPath : getRootPath() +'/global/editor/plugins/code/prettify.css',

uploadJson : getRootPath() +'/uploadController?agentId='+agentId+'&nextDirName=agent&uploadType=image',

fileManagerJson : getRootPath() +'/fileManager?agentId='+agentId+'&nextDirName=agent&uploadType=image',

items:['source' , 'fullscreen', '|', 'justifyleft', 'justifycenter', 'justifyright', 'justifyfull', 'insertorderedlist','|', 'insertunorderedlist', 'indent', 'outdent',

       'clearhtml', 'quickformat', '|', 'formatblock', 'fontname', 'fontsize', '|', 'forecolor', 'hilitecolor', 'bold', 'lineheight', 'removeformat', '|', 'image', 'table', 'hr', 'baidumap'],

allowFileManager : true,

resizeType : 0,

urlType:"domain",

afterBlur: function(){this.sync();},

});

prettyPrint();

});

}

配置參數

1、id

TEXTAREA輸入框的ID，必須設定。

資料類型：String

2、items

配置編輯器的工具欄，其中"-"表示換行，"|"表示分隔符。

資料類型：Array

預設值：

['source', '|', 'fullscreen', 'undo', 'redo', 'print', 'cut', 'copy', 'paste',

'plainpaste', 'wordpaste', '|', 'justifyleft', 'justifycenter', 'justifyright',

'justifyfull', 'insertorderedlist', 'insertunorderedlist', 'indent', 'outdent','subscript',

'superscript', '|', 'selectall', '-',

'title', 'fontname', 'fontsize', '|', 'textcolor', 'bgcolor', 'bold',

'italic', 'underline', 'strikethrough', 'removeformat', '|', 'image',

'flash', 'media', 'advtable', 'hr', 'emoticons', 'link', 'unlink', '|', 'about']

3、width

編輯器的寬度，可以設定px或%，比TEXTAREA輸入框樣式表寬度優先度高。

資料類型：String

預設值：TEXTAREA輸入框的寬度

注: 3.2版本開始支援。

4、height

編輯器的高度，隻能設定px，比TEXTAREA輸入框樣式表高度優先度高。

資料類型：String

預設值：TEXTAREA輸入框的高度

注: 3.2版本開始支援。

5、minWidth

資料類型：Int

指定編輯器最小寬度，機關為px。

預設值：200

6、minHeight

資料類型：Int

指定編輯器最小高度，機關為px。

預設值：100

7、filterMode

資料類型：Boolean

true時過濾HTML代碼，false時允許輸入任何代碼。

預設值：false

注: 3.4以前版本的filterMode預設值為true。

8、htmlTags

指定要保留的HTML标記和屬性。哈希數組的key為HTML标簽名，value為HTML屬性數組，"."開始的屬性表示style屬性。

資料類型：Object

預設值：

{

    font : ['color', 'size', 'face', '.background-color'],

    span : ['style'],

    div : ['class', 'align', 'style'],

    table:['class', 'border', 'cellspacing', 'cellpadding', 'width', 'height','align', 'style'],

    'td,th':['class', 'align', 'valign', 'width', 'height',

             'colspan', 'rowspan', 'bgcolor', 'style'],

    a : ['class', 'href', 'target', 'name', 'style'],

    embed : ['src', 'width', 'height', 'type', 'loop', 'autostart', 'quality',

              'style', 'align', 'allowscriptaccess', '/'],

    img : ['src', 'width', 'height', 'border', 'alt', 'title', 'align', 'style', '/'],

    hr : ['class', '/'],

    br : ['/'],

    'p,ol,ul,li,blockquote,h1,h2,h3,h4,h5,h6' : ['align', 'style'],

    'tbody,tr,strong,b,sub,sup,em,i,u,strike' : []

}     

注：filterMode為true時有效。3.4版本開始屬性可設定style，保留所有inline樣式。

9、resizeMode

2或1或0，2時可以拖動改變寬度和高度，1時隻能改變高度，0時不能拖動。

資料類型：Int

預設值：2

10、skinType

風格類型，default或tinymce。

資料類型：String

預設值：default

注：3.4以前版本和3.4.1版本開始預設值為default，3.4版本的預設值為oxygen。

11、wyswygMode

可視化模式或代碼模式

資料類型：Boolean

預設值：true

12、cssPath

指定編輯器iframe document的CSS，用于設定可視化區域的樣式。

資料類型：String或Array

預設值：空

注：3.4.1版本開始可指定多個CSS檔案。例如：cssPath : ['a.css', 'b.css']

13、skinsPath

指定編輯器的skins目錄，skins目錄存放風格的css檔案和gif圖檔。

資料類型：String

預設值：KE.scriptPath + 'skins/'

14、pluginsPath

指定編輯器的plugins目錄。

資料類型：String

預設值：KE.scriptPath + 'plugins/'

15、minChangeSize

undo/redo文字輸入最小變化長度，當輸入的文字變化小于這個長度時不會添加到undo堆棧裡。

資料類型：Int

預設值：5

16、loadStyleMode

true時自動加載編輯器的CSS。

資料類型：Boolean

預設值：true

注: 3.4版本開始支援。

17、urlType

改變站内本地URL，可設定空、relative、absolute、domain。

空為不修改URL，relative為相對路徑，absolute為絕對路徑，domain為帶域名的絕對路徑。

資料類型：String

預設值：空

注: 3.4版本開始支援，3.4.1版本開始預設值為空。

18、newlineTag

設定回車換行标簽，可設定p、br。

資料類型：String

預設值：br

注: 3.4版本開始支援。

19、afterCreate

設定編輯器建立後執行的回調函數。

資料類型：Function

預設值：無

20、afterDialogCreate

設定彈出浮動框建立後執行的回調函數。

資料類型：Function

預設值：無

注: 3.4.3版本開始支援。

21、allowUpload

true或false，true時顯示上傳圖檔标簽。

資料類型：Boolean

預設值：true

注: 3.4版本開始支援。

22、allowFileManager

true或false，true時顯示浏覽伺服器圖檔功能。

資料類型：Boolean

預設值：false

注: 3.4版本開始支援。

23、referMethod

設定referMethod後上傳圖檔的POST參數裡有referMethod。

資料類型：String

預設值：空

注: 3.4版本開始支援。

24、dialogAlignType

設定彈出框(dialog)的對齊類型，可設定page和空。

指定page時按目前頁面居中，指定空時按編輯器居中。

資料類型：String

預設值：page

注: 3.4.1版本開始支援。

25、imageUploadJson

指定上傳圖檔的伺服器端程式。

資料類型：String

預設值：../../php/upload_json.php

注: 3.4.1版本開始支援。

26、fileManagerJson

指定浏覽遠端圖檔的伺服器端程式。

資料類型：String

預設值：../../php/file_manager_json.php

注: 3.4.1版本開始支援。

27、autoSetDataMode

true或false。

true時自動将編輯器内容設定到原來的textarea，也就是每次輸入内容就執行KE.util.setData函數。

資料類型：Boolean

預設值：true

注: 3.5版本開始支援。打開autoSetDataMode模式後會降低輸入性能，理想的做法是關閉autoSetDataMode，送出資料前執行KE.util.setData。

28、afterSetData

自動執行KE.util.setData後執行的回調函數，autoSetDataMode為true時有效。

資料類型：Function

預設值：無

注: 3.5版本開始支援。

29、shadowMode

true或false，true時彈出層顯示陰影。

資料類型：Boolean

預設值：true

注: 3.5版本開始支援。

30、allowPreviewEmoticons

true或false，true時滑鼠放在表情上可以預覽表情。

資料類型：Boolean

預設值：true

注: 3.5版本開始支援。