CKEditor使用笔记

相关资源

1. 首页地址：http://ckeditor.com/

2. 下载地址：http://ckeditor.com/download

3. SDK地址：http://sdk.ckeditor.com/

如何开始

1、选择位置，放置CKEditor的包

如：放置在webapp/plugin路径下，其中webapp是web项目的根目录。

2、在页面中引入ckeditor.js

<script type="text/javascript" src="${pageContext.request.contextPath}/plugin/ckeditor/ckeditor.js"></script>

3、在页面中定义textarea，定义id和name属性

<textarea id="editor" name="content"></textarea>

4、激活控件

在页面加载完成后调用下述语句：

CKEDITOR.replace("editor"); // 指定textarea的id或name

如果顺利，可以看到效果：

补充：

1. 激活控件需要指定textarea的id或name，优先使用id，name用于作为请求参数的key。

2. 激活控件之后，原textarea隐藏，CKEditor取代textarea展示。控件中输入的内容和隐藏的textarea的内容不是实时同步的，目前所知，表单提交前是会同步的，后台根据textarea的name获取的参数值和ckeditor的输入是一致的。

3. 如果想在js随时获取控件的内容，可以使用下述的语句：

var value = CKEDITOR.instances.editor.getData();

注意：editor是CKEDITOR的一个instance，与激活控件时传入的字符串一致。

自定义配置

ckeditor/config.js文件用于CKEditor的配置。刚下载下来时，内容如下：

/**
 * @license Copyright (c) 2003-2015, CKSource - Frederico Knabben. All rights reserved.
 * For licensing, see LICENSE.md or http://ckeditor.com/license
 */
 
CKEDITOR.editorConfig = function( config ) {
    // Define changes to default configuration here. For example:
    // config.language = 'fr';
    // config.uiColor = '#AADC6E';
};

我们需要自定义配置，写在方法里。

配置工具栏

CKEditor划分了三个版本，支持详简不同的工具栏。如果我们需要在此基础上进行配置，可以使用下载包里提供的配置工具，直接以本浏览器打开/ckeditor/samples/toolbarconfigurator/index.html

工具栏的层级划分：行 — 工具条 — 组 — 项目。行与行之间，以row separator分隔；工具条之间有明显的间距；组之间有竖线。

配置完成之后，点击Get toolbar config按钮，可以得到一份源码，将源码copy到config.js中，就实现了工具栏的配置。

字体配置

config.font_names = '宋体/SimSun;新宋体/NSimSun;仿宋/FangSong';

如：将上述代码复制到config.js的方法中，可以配置控件的字体分别为宋体、新宋体、仿宋。

控件可以配置多个字体实体，字体之间以;分隔。字体又分显示名和设置名之别，以/分隔；显示名用于在控件中显示，设置名用于设置对应的font-family，所以设置名不能随意填写。如，按照上述的配置，选择了新宋体之后，输出的代码为style="font-family:nsimsun"。

font-family可以设置多个字体的序列，所以控件的一个字体实体，可以有多个输出名，以,分隔。如：

config.font_names = 'Times New Roman/Times New Roman, Times, serif';

换行模式配置

在默认的情况下，Enter键是添加一个p标签，而Shift+Enter是添加一个br标签。控件提供了三种模式：

1. CKEDITOR.ENTER_P

新增一个p标签

2. CKEDITOR.ENTER_BR

新增一个br标签

3. CKEDITOR.ENTER_DIV

新增一个div标签

---

控件使用下述的参数名来配置模式：

1. enterMode

配置单击Enter键的模式

2. shiftEnterMode

配置Shift + Enter组合键的模式

---

如下述代码：

config.enterMode = CKEDITOR.ENTER_BR; // 配置Enter是换行
config.shiftEnterMode = CKEDITOR.ENTER_P; // 配置Shift + Enter是换段落

更多配置

参考CKEDITOR.config的API。

配置的方式

除了上文中描述的，直接修改config.js文件，还有另外两种配置的方式。

1. 激活时配置

CKEDITOR.replace( 'editor', {
    language: 'fr',
    uiColor: '#9AB8F3'
});

2. 自定义配置文件

CKEDITOR.replace( 'editor1', {
    customConfig: '/custom/ckeditor_config.js'
});

要求自定义配置文件的结构和默认的config.js一致。

功能试炼

1、初始最大化

CKEDITOR.editor有事件instanceReady，CKEDITOR.editor#on( 'instanceReady', function(evt) )可以捕捉控件初始化完成的时机；

CKEDITOR.instances.editorId可以获取指定editorId的CKEDITOR.editor实例；

CKEDITOR.editor#execCommand( commandName, [data] )用于执行命令，'maximize'是最大化命令；

结合以上知识，我们可以得到代码

CKEDITOR.instances.editor.on('instanceReady', function (e) {
    CKEDITOR.instances.editor.execCommand('maximize'); // 初始最大化
});

2、获取控件的富文本内容

CKEDITOR.editor#getData()可用于获取富文本的内容

var value = CKEDITOR.instances.editor.getData();

3、打印预览

CKEDITOR.instances.editor.execCommand('preview');  // 预览
CKEDITOR.instances.editor.execCommand('print');  // 打印

---

关于execCommand的说明

"maximize"是最大化的命令，"preview"是预览的命令，"print"的命令。大家一定想要一份command的清单，求知有哪些命令可供我们使用。很遗憾，我没有找到这样的清单，通过走读源码，在ckeditor.js中，会调用CKEDITOR.plugins.add( {String}name, {Object}[definition] )来注册资源，"maximize"、"preview"、"print"都在其中。

通过关键字匹配，共有72个资源：

dialogui, dialog, about, a11yhelp, dialogadvtab, basicstyles, bidi, blockquote, clipboard, button, panelbutton, panel, floatpanel, colorbutton, colordialog, templates, menu, contextmenu, div, resize, toolbar, elementspath, enterkey, entities, popup, filebrowser, find, fakeobjects, flash, floatingspace, listblock, richcombo, font, forms, format, horizontalrule, htmlwriter, iframe, wysiwygarea, image, indent, indentblock, indentlist, smiley, justify, menubutton, language, link, list, liststyle, magicline, maximize, newpage, pagebreak, pastetext, pastefromword, preview, print, removeformat, save, selectall, showblocks, showborders, sourcearea, specialchar, scayt, stylescombo, tab, table, tabletools, undo, wsc

 

Technorati 标签: CKEditor使用,CKEditor配置