设置 CKEditor 的配置

发布于 2015-08-19 11:29:01 | 888 次阅读 | 评论: 0 | 来源: PHPERZ

1 、 设置 CKEditor  的配置

CKEditor 具有丰富的一组配置选项，可以定制其外观、功能和行为。主配置文件名字为config.js。此文件可以在 CKEditor 安装文件夹的根目录中找到。

可用的配置选项

在 API 文档中可以找到所有可用的配置选项。参考 CKEDITOR.config 对象的定义。

在页面中（In-Page ）定义配置

设置 CKEditor 的最好方法是当生成了编辑器实例时，在页面中设置。此方法可以使你避免修改 CKEditor 安装文件夹中最初发布的文件，使升级任务更容易。
在 页 面 中 可 将 设 置 传 给 任 意 编 辑 器 实 例 生 成 函 数 ， 即 CKEDITOR.replace 和

CKEDITOR.appendTo。例如：
CKEDITOR.replace( 'editor1', {
toolbar : 'Basic',
uiColor : '#9AB8F3'
5
});

注意通过一个字面对象定义（以“ ｛”符号开始，以“｝ ”符号结束）来传递配置选项。
因此，每个选项的正确语法是（"配置的名字"）:（"配置的值"） 。一定不要在冒号字符（:）处使用“等于”字符（=） 。

使用 config.js  文件

也可以通过使用 config.js 文件来配置 CKEditor 的设置。此文件缺省情况几乎为空。要改变 CKEditor 的配置，将你想要修改的设置增加到 config.js 文件中。例如：

CKEDITOR.editorConfig = function( config ) {
config.language = 'fr';
config.uiColor = '#AADC6E';
};

为了应用配置设置，必须总是要定义 CKEDITOR.editorConfig 函数。config.js 文件将在页面范围中被执行，故你还可以引用在页面（In-Page）或者甚至是其它 JavaScript 文件中定义的变量。

使用定制的配置文件

使 用定制的配置文件是另一种推荐的设置 CKEditor 配置的方法。不使用缺省的 config.js文件，你可以将此文件复制到站点的任何地方，并简单地引导编辑器加载它。此方法的优点是采用此方法可以避免改变原始的文件， 从而使以后升级 CKEditor 更容易， 只是简单地覆盖所有的文件。
假设你将 config.js 文件复制到你的站点根目录下一个叫 custom 的文件夹中。你还将此文件更名为 ckeditor_config.js。此时，要使用定义在文件中的定制设置，只需在生成编辑器实例时，设置 customConfig 配置选项即可。例如：

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

定制的配置文件必须看起来像缺省的 config.js 文件。

配置的加载顺序

不要求你仅使用一种上述配置选项。可以混用上述方法，并且可以正确地加载配置。下面的列表表示在生成编辑器实例时所使用的配置加载顺序：

• 生成一个编辑器的实例。此时，其所有配置项设置为缺少值。
• 如果在页面中（in-page）中有配置设置，该文件被加载，否则加载缺省的 config.js文件。在定制配置文件中的所有设置覆盖当前实例的配置。
• 如果在第二步加载的设置中还定义了新的 customConfig 值， 就加载另一个配置文件，且其设置覆盖实例的当前设置。对所有文件递归，直到没有再定义 customConfig。
• 最终，在页面中(in-page)中定义的设置覆盖实例的当前设置（除了 customConfig，它已在第一步中使用过了） 。

避免加载外部的设置文件

也可能完全避免加载外部的配置文件，以减少加载的文件数。为此，你需要将CKEDITOR.config.customConfig 设置为空字符串。例如：

CKEDITOR.replace( 'editor1', {
customConfig : ' '
});

如果你在 config.js 文件中没有配置，也没有定制的配置文件，则一定推荐此设置。