KindEditor-編輯器配置參數屬性

在《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'],
    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版本開始支持。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章