1
return top
editor具有丰富的配置来定制它的用户界面,特性和功能,主要的配置文件名为“config.js”。它在CKEditor安装文件夹的根目录上。
Power by xuan at 2009-11-03 11:41
2
return top
可用的配置选项
所有可用的配置选项可以再我们的api文档中找到, 在 CKEDITOR.config
Power by xuan at 2009-11-03 11:43
3
return top
在页面中配置
设置配置的最好方式是在你的页面中,在创建editor示例的时候。这样你就不用修改安装文件夹的原始分发文件了, 并且更易使用。
页面配置这种方式,可以在任何editor实例化函数中使用,也就是 CKEDITOR.replace 和 CKEDITOR.appendTo . 例如
1 | CKEDITOR.replace( 'editor1' , |
注意配置属性石通过字面对象定义, (以 "{"开头和以 "}"结尾)的键值对,因此,正确的语法是 (configuration name) + ":" + (configuration value). 请不要使用“=” 。
Power by xuan at 2009-11-04 09:05
4
return top
使用config.js 文件来配置
你也可以吧你的配置放在config.js文件中,你会注意到那个文件默认几乎是空的。你只需简单的把想要改变的配置加入到文件中。例如
1 | CKEDITOR.editorConfig = function ( config ) |
3 | config.language = 'fr' ; |
4 | config.uiColor = '#AADC6E' ; |
上面的 CKEDITOR.editorConfig函数定义必需总是存在这样设置才能起作用。这个配置文件会在你的页面范围内执行,所以你也可以把配置保存在一个定义在页面中的变量,或者在另外一个JavaScript文件。
Power by xuan at 2009-11-03 12:13
5
return top
使用用户配置文件
这是另外一个被推荐的方式来设置你的配置,作为使用默认的config.js文件的替代,你可以复制一份那个文件到你网站的任何地方,并指引你的 editor实例化去装载它,这样的优点是你可以避免改变原始的文件,让以后更新CKEditor更加容易,只需要简单的覆盖所有的文件。
假设你复制了config.js到一个在你网站根目录的命为”custom“文件夹内,并把文件重命名为"ckeditor_config.js",这样的话,你只需要设置 customConfig 当你创建editor实例的时候. 例如:
1 | CKEDITOR.replace( 'editor1' , |
3 | customConfig : '/custom/ckeditor_config.js' |
你的自定义的配置文件必须与默认的config.js的格式一致。
Power by xuan at 2009-11-03 18:14
6
return top
配置重新装载顺序
没有只能使用一个配置选项的限制,你可以混合的使用它们,并且配置能够正确地重新装载。下面是创建editor实例时配置加载的顺序。
- 创建editor实例,这时所有的默认配置将会设置。
- 如果用户customConfig被设置为 "in-page",则这个文件会被加载,否则的话默认的config.js将会被加载。所有config.js中的设置将会覆盖当前实例的设置。
- 如果第二步中的设置同样定义了一个新的customConfig值,则新的文件将会加载并且它的设置将会覆盖当前实例的设置。这将会重复的发生直到没有customConfig被定义。
- 最后,定义为"in-page"的设置将会覆盖当前实例的设置。(除了在第一点中提到的customConfig,)
Power by xuan at 2009-11-03 18:30
7
return top
避免加载外部的配置文件
完全可以避免加载I外部的配置文件,减少要加载的文件的数量。只需要设置 customConfig 为空字符串就可以了,例如
1 | CKEDITOR.replace( 'editor1' , |
如果你没有在config.js或用户配置文件中设置配置的话,这种方式是极力推荐的。
Power by xuan at 2009-11-03 20:42