在《KindEditor-KindEditor簡介》中提到了KindEditor編輯器的使用方法,通過使用KE.show(config)方法即可將編輯器添加到文檔中。下面是一段源碼:
KE.show = function(args) {
KE.init(args);
KE.event.ready(function() { KE.create(args.id); });
};
從源碼中可以看出,有兩種使用編輯器的方法:
法一:KE.show(config);
法二:KE.init(config);KE.create(id);
無論使用哪種方式使用KindEditor編輯器,都必須進行參數配置;
可以在KE.show()和KE.init()方法中傳遞配置參數config;
配置參數config是一個對象,一般使用字面量對象;
其中,id參數是唯一必須進行配置的,其他參數可以省略。
參數設定例子
KE.show({
id : "content_1",
width : "70%", //編輯器的寬度為70%
height : "200px", //編輯器的高度為100px
filterMode : false, //不會過濾HTML代碼
resizeMode : 1 //編輯器只能調整高度
});
配置參數
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'],