ckeditor中文文档——开发者文档（3）配置--配置设置

原文地址:http://www.docwar.com/b/15001/5.htm

editor具有丰富的配置来定制它的用户界面，特性和功能，主要的配置文件名为“config.js”。它在CKEditor安装文件夹的根目录上。

 

可用的配置选项

所有可用的配置选项可以再我们的api文档中找到, 在 CKEDITOR.config

 

在页面中配置

设置配置的最好方式是在你的页面中，在创建editor示例的时候。这样你就不用修改安装文件夹的原始分发文件了, 并且更易使用。

页面配置这种方式，可以在任何editor实例化函数中使用，也就是 CKEDITOR.replace 和 CKEDITOR.appendTo . 例如

 

CKEDITOR.replace( 'editor1', { toolbar : 'Basic', uiColor : '#9AB8F3' });

 

注意配置属性石通过字面对象定义， (以 "{"开头和以 "}"结尾)的键值对，因此，正确的语法是 (configuration name) + ":" +







 (configuration value). 请不要使用“=” 。

使用config.js 文件来配置

你也可以吧你的配置放在config.js文件中，你会注意到那个文件默认几乎是空的。你只需简单的把想要改变的配置加入到文件中。例如

1	CKEDITOR.editorConfig = function ( config )

2

{

3	config.language = 'fr' ;

4	config.uiColor = '#AADC6E' ;

5

};

上面的 CKEDITOR.editorConfig函数定义必需总是存在这样设置才能起作用。这个配置文件会在你的页面范围内执行，







所以你也可以把配置保存在一个定义在页面中的变量，或者在另外一个JavaScript文件。

使用用户配置文件

这是另外一个被推荐的方式来设置你的配置，作为使用默认的config.js文件的替代，你可以复制一份那个文件到你网站的任何地方，并指引你的 editor实例化去装载它，这样的优点是你可以避免改变原始的文件，让以后更新CKEditor更加容易，只需要简单的覆盖所有的文件。

假设你复制了config.js到一个在你网站根目录的命为”custom“文件夹内，并把文件重命名为"ckeditor_config.js"，这样的话，你只需要设置 customConfig 当你创建editor实例的时候. 例如：

 

1	CKEDITOR.replace( 'editor1' ,

2

{

3	customConfig : '/custom/ckeditor_config.js'

4

});

你的自定义的配置文件必须与默认的config.js的格式一致。

配置重新装载顺序

没有只能使用一个配置选项的限制，你可以混合的使用它们，并且配置能够正确地重新装载。下面是创建editor实例时配置加载的顺序。

1. 创建editor实例，这时所有的默认配置将会设置。
2. 如果用户customConfig被设置为 "in-page",则这个文件会被加载，否则的话默认的config.js将会被加载。所有config.js中的设置将会覆盖当前实例的设置。
3. 如果第二步中的设置同样定义了一个新的customConfig值，则新的文件将会加载并且它的设置将会覆盖当前实例的设置。这将会重复的发生直到没有customConfig被定义。
4. 最后，定义为"in-page"的设置将会覆盖当前实例的设置。（除了在第一点中提到的customConfig，）

避免加载外部的配置文件

完全可以避免加载I外部的配置文件,减少要加载的文件的数量。只需要设置 customConfig 为空字符串就可以了，例如

view source

print ?

1	CKEDITOR.replace( 'editor1' ,

2

{

3	customConfig : ''

4

});

如果你没有在config.js或用户配置文件中设置配置的话，这种方式是极力推荐的。