CKEditor4配置与开发详细中文说明文档(4)

日期：2020-05-11 栏目：程序人生浏览：次

可用的配置选项

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

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

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

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

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

使用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文件。

配置的加载顺序

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