编辑“KindEditor/使用方法”

{{KindEditor导航}}

===下载编辑器===

===部署编辑器===
解压 kindeditor-x.x.x.zip 文件，将所有文件上传到自己的网站程序目录里，例如：<nowiki>http://网站域名/editor/</nowiki>

Note：

可以根据需求删除以下目录后上传到[[服务器]]。

*[[asp]] - ASP程序
*[[asp.net]] - ASP.NET程序
*[[php]] - PHP程序
*[[jsp]] - JSP程序
*examples - 演示文件

===修改HTML页面===
1、在需要显示[[编辑器]]的位置添加textarea输入框。
<pre>
<textarea id="editor_id" name="content" style="width:700px;height:300px;">
&lt;strong&gt;HTML内容&lt;/strong&gt;
</textarea>
</pre>
Note：
*id在当前页面必须是唯一的值。
*在textarea里设置[[HTML]]内容即可实现编辑，在这里需要注意的是，如果从[[服务器]]端程序(ASP、PHP、ASP.NET等)直接显示内容，则必须转换HTML特殊字符(>,<,&,”)。具体请参考各语言目录下面的demo.xxx程序，目前支持ASP、ASP.NET、PHP、JSP。
*在有些[[浏览器]]上不设宽度和高度可能显示有问题，所以最好设一下宽度和高度。宽度和高度可用inline样式设置，也可用编辑器初始化参数设置。

2、在该HTML页面添加以下脚本。
<pre>
<script charset="utf-8" src="/editor/kindeditor.js"></script>
<script charset="utf-8" src="/editor/lang/zh_CN.js"></script>
<script>
        var editor;
        KindEditor.ready(function(K) {
                editor = K.create('#editor_id');
        });
</script>
</pre>
Note：
*第一个参数可用其它[[CSS]]选择器，匹配多个textarea时只在第一个元素上加载编辑器。
*通过K.create函数的第二个参数，可以对编辑器进行配置。
<pre>
var options = {
        cssPath : '/css/index.css',
        filterMode : true
};
var editor = K.create('textarea[name="content"]', options);
</pre>

===获取HTML数据===
<pre>
// 取得HTML内容
html = editor.html();

// 同步数据后可以直接取得textarea的value
editor.sync();
html = document.getElementById('editor_id').value; // 原生API
html = K('#editor_id').val(); // KindEditor Node API
html = $('#editor_id').val(); // jQuery

// 设置HTML内容
editor.html('HTML内容');
</pre>
Note：
*KindEditor的可视化操作在新创建的iframe上执行，代码模式下的textarea框也是新创建的，所以最后提交前需要将HTML数据同步到原来的textarea，editor.sync()函数会完成这个动作。
*KindEditor在默认情况下自动寻找textarea所属的form元素，找到form后onsubmit事件里添加sync函数，所以用form方式提交数据，不需要手动执行sync()函数。

==参考来源==
*http://www.kindsoft.net/doc.php 


[[category:KindEditor|S]]
{{KindEditor使用手册导航}}