初始方式:

说明: 在快速入门中使用KE.show({ .. .})来初始化了一个编辑器,具体进入js/kindeditor.js下可以看到KE对象下的show方法先调用了KE的init方法然后又调用了其event事件对象的ready方法,内部其实是调用的KE的create方法,传递的参数为args的id属性,所以可通过2种方式来初始化编辑器

# 方式一 :

# 方式二 :

注意: 无论使用哪种方式初始化编辑器,都需要传递配置对象{ ... },配置对象中id属性是必须配置的,其它的属性默认采用默认配置,全部可以不配置.

配置方法:

说明: 上面2种方式初始化时候首先调用了kindeditor.js里的KE对象的init方法,进入方法可以看到首先var g = KE.g[args.id] = args,KE.g[args.id],g和KE.g[args.id]全部指向了args对象,然后2219~2222行通过KE.each遍历KE.setting对象的键值对如果args中没有定义KE.setting中的键值对则默认使用KE.setting中定义的键值对作为默认值,可以搜索下KE.setting看下相关的默认配置

扩展: 从上面可以看出要自定义配置参数第一种方式是通过在KE.show({...})的时候定义在传递的对象中,第二种方式是通过修改kindeditor.js中KE.setting对象相关配置.

配置参数:

KE.show({//说明:TextArea输入框Id,必须设置,数据类型为Stringid:'content1',//说明:配置编辑器的工具栏,其中'-'表示换行符,'|'表示分割符,数据类型为Arrayitems:['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','p_w_picpath','flash','media','table','hr','emoticons','link','unlink','about'],//说明:设置编辑器的宽度,可以设置px或%,默认会比TextArea输入框样式表宽度优先//度高,数据类型为Stringwidth:'100%',//说明:设置编辑器的高度,只能设置px,默认会比TextArea输入框样式表高度优先//度高,数据类型为Stringheight:'300px',//说明:设置编辑器最小宽度,只能设置px,数据类型为IntminWidth:1168,//说明:设置编辑器最小高度,只能设置px,数据类型为IntminHeight:300,//说明:设置在源码模式下是否根据htmlTags过滤HTML代码,当为true时,在htmlTags//中的元素只保留指定的属性,其它的被过滤掉,当为false时则htmlTags不会启任何作//用,数据类型为BooleanfilterMode:false,//说明:配合filterMode一起使用设置要保留标记和属性,哈希数组的Key为标签名,//value是要保留的属性数组,.开始的属性表示style属性,数据类型为ObjecthtmlTags:{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,h2,h3,h4,h5,h6,h7':['align','style'],'tbody,tr,strong,b,sub,sup,em,i,u,strike':[]},//说明:设置拖动方式,2表示可以水平或竖直拖动,1表示只可竖直拖到,0表示禁止拖//动,数据类型为IntresizeMode:1,//说明:设置风格类型,主题文件位于js/kindeditor/skins下,数据类型为StringskinType:'tinymce',//说明:设置是否默认为可视化模式,true表示可视化模式,false表示代码编辑模式,//数据类型为BooleanwyswygMode:true,//说明:设置编辑器iframedocument的CSS,用于设置可视化区域的样式,用于设置可//视化区域的样式,数据类型为String或ArraycssPath:KE.scriptPath+'index.css',//说明:设置默认皮肤的目录,包含一些风格相关的css文件和gif图片,默认位于js///kindeditor/skins下,默认值为KE.scriptPath+'skins/',数据类型为StringskinsPath:KE.scriptPath+'skins/',//说明:设置默认插件的目录,默认位于js/kindeditor/plugin,数据类型为StringpluginsPath:KE.scriptPath+'plugins/',//说明:设置文字输入的最小变化长度,当到达此长度时才会记录到上一步undo和重复//redo堆栈中(其实就是push到对应的数组),数据类型为IntminChangeSize:1,//说明:设置是否自动加载编辑器主题的CSS,默认为g.skinsPath+g.skinType+//'.css',数据类型为BooleanloadStyleMode:true,//说明:设置站内本地URL,可设置空/relative/absolute/domain,空表示不修改URL,//relative表示相对路径,absolute表示绝对路径,domain表示带域名的绝对路径,常用//于编辑器内资源文件引用的是其它路径或地址,数据类型为StringurlType:'',//说明:设置换行符标签,可设置br或p,默认为br,数据类型为StringnewlineTag:'br',//说明:设置编辑器创建后执行的回调函数,作为编辑器初始化之后的其它初始化,如//下e其实就是content1,而内部的this其实就是id为content1编辑器对象,数据类型为//functionafterCreate:function(e){console.log(this);},//说明:设置图片上传时是否显示本地上传,true表示显示本地上传,false表示不支持//数据类型为BooleanallowUpload:true,//说明:设置图片上传时网络上传时是否可浏览远程服务器图片功能,true表示显示,//false表示不显示,数据类型为BooleanallowFileManager:true,//说明:设置referMethod后上传图片的POST参数里有referMethod,数据类型为StringreferMethod:'',//说明:设置弹出框的对齐类型,可设置为page或空,page为相对于页面居中,空表示相//对于编辑器居中dialogAlignType:'page',//说明:设置上传图片时服务端处理脚本,数据类型为Stringp_w_picpathUploadJson:KE.scriptPath+'php/upload_json.php',//说明:设置浏览远程图片服务端处理脚本,数据类型为StringfileManagerJson:KE.scriptPath+'php/file_manager_json.php'});

说明: 如上是kindeditor-3.4.2版本支持的所有选项,具体可手动修改index.js测试,高版本新增参数可参考http://kindeditor.net/doc3.php?cmd=config.