当前位置:文档之家› kindeditor使用方法==

kindeditor使用方法==

kindeditor详细使用说明1.下载KindEditor 最新版本。

打开下载页面2. 解压zip文件,将所有文件上传到您的网站程序目录下。

例如:http://您的域名/editor/3.在需要显示编辑器的位置添加TEXTAREA输入框。

id在当前页面必须是唯一的值,还有,在有些浏览器上不设宽度和高度可能显示有问题,所以最好设一下宽度和高度。

宽度和高度可用inline样式设置,也可用编辑器初始化参数设置。

在TEXTAREA里设置HTML内容即可实现编辑,在这里需要注意的是,如果从服务器端程序(ASP、PHP、等)直接显示内容,则必须转换HTML特殊字符(>,<,&,")。

具体请参考各语言目录下面的demo.xxx程序,目前支持ASP、、PHP、JSP。

<textarea id="editor_id" name="content" style="width:700px;height:300px;">&lt;strong&gt;HTML内容&lt;/strong&gt;</textarea>4.在该HTML页面添加以下脚本。

<script charset="utf-8" src="/editor/kindeditor.js"></script><script> KE.show({ id : 'editor_id' });</script>注:KE.show的原理是先执行KE.init设置一些变量,等DOM 全部创建以后才开始执行KE.create创建编辑器。

如果浏览器不触发DOMContentLoaded事件(例如:jQuery的$.ready,点击某个按钮,通过innerHTML 插入HTML等),则不能使用KE.show,需要直接调用KE.init和KE.create。

KE.init({ id : 'editor_id'});$.ready(function() { KE.create('editor_id');});调用KE.show和KE.init时,除id之外还可以设置其它的参数,具体属性请参考编辑器初始化参数。

5.取得编辑器的HTML内容。

KindEditor的可视化操作在新创建的iframe上执行,代码模式下的textarea框也是新创建的,所以最后提交前需要将HTML数据同步到原来的textarea,KE.sync函数会完成这个动作。

KindEditor在默认情况下自动寻找textarea所属的form元素,找到form后onsubmit 事件里添加KE.sync函数,所以用form方式提交数据,不需要手动执行KE.sync函数。

//取得HTML内容html = KE.html('editor_id');//同步数据后可以直接取得textarea的valueKE.sync('editor_id');html = document.getElementById('editor_id').value;html = $('#editor_id').val(); //jQuery//设置HTML内容KE.html('editor_id', 'HTML内容');编辑器初始化参数1.调用KE.show或KE.init时可以设置以下参数。

1.idTEXTAREA输入框的ID,必须设置。

数据类型:String2.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。

默认值:2006.minHeight数据类型:Int指定编辑器最小高度,单位为px。

默认值:1007.filterMode数据类型:Booleantrue时过滤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.resizeMode2或1或0,2时可以拖动改变宽度和高度,1时只能改变高度,0时不能拖动。

数据类型:Int默认值:210.skinType风格类型,default数据类型:String默认值:default11.wyswygMode可视化模式或代码模式数据类型:Boolean默认值:true12.cssPath指定编辑器iframe document的CSS,用于设置可视化区域的样式。

数据类型:String或Array默认值:空注:3.4.1版本开始可指定多个CSS文件。

相关主题