KindEditor使用简介

原文地址:http://web.jofar.cn/article.php?id=67

对应Kindeditor这个编辑器插件,用起来还是非常容易的,但有时一些参数容易忘记,正好看到网上有篇文章讲到kindeditor的参数,感觉很全面,就转载过来了。


参数设置例子

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版本开始支持。

你可能感兴趣的:(jquery,kindeditor)