fckeditor - 配置(3)

参看文档：http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide/Configuration/Configuration_File

自定义配置方法

1.直接修改主配置文件fckconfig.js

fck主配置文件：fckeditor/fckconfig.js



2.定义单独的配置文件（只需要写需要修改的配置项）


2.1.创建myfckconfig.js配置自定义属性

将myfckconfig.js放入fckeditor/editor文件夹下，

//系统是否自动检测并运用适当的语言界面
FCKConfig.AutoDetectLanguage = false ;
//手动设置默认的语言：法语
FCKConfig.DefaultLanguage = "fr" ;


2.2载入自定义配置文件
方法一：全局载入(对工程中所有fckeditor有效)
在fckconfig.js找到

FCKConfig.CustomConfigurationsPath = '' ;
输入myfckconfig.js位置，FCKConfig.BasePath值fckeditor/editor文件夹

FCKConfig.CustomConfigurationsPath = FCKConfig.BasePath+'myfckconfig.js ' ;

方法二：局部载入（只对当前网页有效）

var oFCKeditor = new FCKeditor( "FCKeditor1" ) ;
oFCKeditor.Config["CustomConfigurationsPath"] = "myconfig.js" ;
oFCKeditor.Create() ;

3.在页面的调用代码中对FCKeditor的实例进行配置

var oFCKeditor = new FCKeditor( "FCKeditor1" ) ;
oFCKeditor.Config["AutoDetectLanguage"] = "fasle" ;
oFCKeditor.Create() ;

配置加载顺序

1.加载主配置文件fckconfig.js

2.加载自定义的配置文件（如果有），覆盖相同的配置项

3.使用对实例的配置覆盖相同的配置项（只对当前实例有效）



主配置文件（fckconfig.js部分属性中文注释）



FCKConfig.CustomConfigurationsPath = '' ; // 自定义配置文件路径和名称
FCKConfigFCKConfig.EditorAreaCSS = FCKConfig.BasePath 'css/fck_editorarea.css'; // 编辑区的样式表文件
FCKConfig.EditorAreaStyles = '' ; // 编辑区的样式表风格
FCKConfig.ToolbarComboPreviewCSS =''; //工具栏预览CSS
FCKConfig.DocType = '' ;//文档类型
FCKConfig.BaseHref = ''; // 相对链接的基地址
FCKConfig.FullPage = false ; //是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容
FCKConfig.StartupShowBlocks = false ;//决定是否启用"显示模块"
FCKConfig.Debug = false ;//是否开启调试功能
FCKConfigFCKConfig.SkinPath = FCKConfig.BasePath 'skins/default/' ; //皮肤路径
FCKConfig.PreloadImages=... //预装入的图片
FCKConfig.PluginsPath = FCKConfig.BasePath 'plugins/' ; //插件路径
FCKConfig.AutoDetectLanguage = true ; //是否自动检测语言
FCKConfig.DefaultLanguage = 'zh-cn' ; //默认语言
FCKConfig.ContentLangDirection = 'ltr' ; //默认的文字方向,可选"ltr/rtl",即从左到右或从右到左
FCKConfig.ProcessHTMLEntities = true ; //处理HTML实体
FCKConfig.IncludeLatinEntities = true ; //包括拉丁文
FCKConfig.IncludeGreekEntities = true ;//包括希腊文
FCKConfig.ProcessNumericEntities = false ;//处理数字实体
FCKConfig.AdditionalNumericEntities = '' ; //附加的数字实体
FCKConfig.FillEmptyBlocks = true ; //是否填充空块
FCKConfig.FormatSource = true ; //在切换到代码视图时是否自动格式化代码
FCKConfig.FormatOutput = true ; //当输出内容时是否自动格式化代码
FCKConfig.FormatIndentator = ' ' ; //当在源码格式下缩进代码使用的字符
FCKConfig.StartupFocus = false ; //开启时焦点是否到编辑器,即打开页面时光标是否停留在fckeditor上
FCKConfig.ForcePasteAsPlainText = false ; //是否强制粘贴为纯文件内容
FCKConfig.AutoDetectPasteFromWord = true ; //是否自动探测从word粘贴文件,仅支持IE
FCKConfig.ShowDropDialog = true ;//是否显示下拉菜单
FCKConfig.ForceSimpleAmpersand = false ;//是否不把&符号转换为XML实体
FCKConfig.TabSpaces = 0 ;//按下Tab键时光标跳格数,默认值为零为不跳格
FCKConfig.ShowBorders = true ;//合并边框
FCKConfig.SourcePopup = false ;//弹出
FCKConfig.ToolbarStartExpanded = true ;//启动fckeditor工具栏默认是否展开
FCKConfig.ToolbarCanCollapse = true ;//是否允许折叠或展开工具栏
FCKConfig.IgnoreEmptyParagraphValue = true ;//是否忽略空的段落值
FCKConfig.FloatingPanelsZIndex = 10000 ;//浮动面板索引
FCKConfig.HtmlEncodeOutput = false ;//是否将HTML编码输出
FCKConfig.TemplateReplaceAll = true ;//是否替换所有模板
FCKConfig.ToolbarLocation = 'In' ;//工具栏位置,
FCKConfig.ToolbarSets = object ; // 编辑器的工具栏，可以自行定义，删减，可参考已存在工具栏
FCKConfig.EnterMode = 'p'; // 编辑器中直接回车，在代码中生成，可选为p | div | br
FCKConfig.ShiftEnterMode = 'br'; // 编辑器中Shift 回车，在代码中生成，可选为p | div | br
FCKConfig.ContextMenu = 字符串数组; // 右键菜单的内容
FCKConfig.FontColors = ""; // 文字颜色列表
FCKConfig.FontNames = ""; // 字体列表
FCKConfig.FontSizes = ""; // 字号列表
FCKConfig.FontFormats = ""; // 文字格式列表
FCKConfig.StylesXmlPath = ""; // CSS样式列表的XML文件的位置
FCKConfig.TemplatesXmlPath = ""; // 模版的XML文件位置
FCKConfig.SpellChecker = "ieSpell/Spellerpages"; // 拼写检查器
FCKConfig.IeSpellDownloadUrl = ""; // 下载拼写检查器的网址
FCKConfig.FullPage = true/false; // 是否允许编辑整个HTML文件，还是仅允许编辑BODY间的内容
var _FileBrowserLanguage = 'php' ; // asp | aspx | cfm | lasso | perl | php | py
var _QuickUploadLanguage = 'php' ;// asp | aspx | cfm | lasso | php[/code] //第一个是文件浏览器使用的语言，第二个快速上传使用的语言，改成你需要的
FCKConfig.LinkUploadAllowedExtensions = "" ; // empty for all
FCKConfig.LinkUploadDeniedExtensions =".(php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi)$" //这是两个允许和拒绝上传的文件类型列表
FCKConfig.ImageBrowser = false ;//是否在插入图片功能里面启用服务器文件浏览功能
FCKConfigFCKConfig.ImageBrowserURL = FCKConfig.BasePath 'filemanager/browser/default/browser.html?Type=ImageConnector=connectors/' _FileBrowserLanguage '/connector.' _FileBrowserExtension ;
//Type=Image 表示文件类型是image这会使文件浏览器定位到文件上传路径/image/文件夹下面
FCKConfig.FlashBrowser = false ;//是否在插入flash功能中启用服务器文件浏览功能
FCKConfig.LinkUpload = false ;//是否启用插入链接的快速上传功能
FCKConfig.ImageUpload = false ;//是否启用图片快速上传功能
FCKConfig.FlashUpload = false ;//是否启用flash上传功能
FCKConfigFCKConfig.SmileyPath = FCKConfig.BasePath 'images/smiley/msn/'; // 表情文件存放路径
FCKConfig.SmileyImages = ''; // 表情文件名称列表，具体参考默认设置
FCKConfig.SmileyColumns = 8; // 表情窗口显示表情列数
FCKConfig.SmileyWindowWidth = 320; // 表情窗口显示宽度，此窗口会因为表情文件的改变而作调整
FCKConfig.SmileyWindowHeight = 240; // 表情窗口显示高度，此窗口会因为表情文件的改变而作调整
常用自定义配置样例



修改语言

FCKConfig.AutoDetectLanguage = false ;
FCKConfig.DefaultLanguage = 'zh-cn' ;

添加中文字体

FCKConfig.FontNames = '宋体;黑体;隶书;楷体_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;


更换换行模式

FCKConfig.EnterMode = 'br' ; // p | div | br
FCKConfig.ShiftEnterMode = 'p' ; // p | div | br

自定义表情

FCKConfig.SmileyPath = FCKConfig.BasePath + 'images/ftl/' ;
FCKConfig.SmileyImages =['01.gif','02.gif','03.gif','04.gif','05.gif','06.gif','07.gif','08.gif','09.gif','10.gif','11.gif','12.gif','13.gif','14.gif','15.gif','16.gif','17.gif','18.gif','19.gif','20.gif','21.gif'] ;
FCKConfig.SmileyColumns = 8 ;
FCKConfig.SmileyWindowWidth = 480 ;
FCKConfig.SmileyWindowHeight = 180 ; 如果表情图片太多，可以设置滚动条

1.在fckeditor/editor/dialog/fck_smiley.html 中找到

window.onload = function ()
{
oEditor.FCKLanguageManager.TranslatePage(document) ;
dialog.SetAutoSize( true ) ;
} 将dialog.SetAutoSize( true ) 改为dialog.SetAutoSize( false)

2.再找到

<body style="overflow: hidden">
<body> 将 hidden改为auto


更换皮肤

FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/office2003/' ;
fckeditor默认提供三种皮肤，如果想得到更多皮肤请访问

http://sourceforge.net/tracker/?atid=740153&group_id=75348&func=browse





自定义工具集

fckeditor提供两种工具集Default/Basic,也可以自己定义

FCKConfig.ToolbarSets["MYTOOLBAR"] = [
['Source','-','FitWindow','-','Preview'],
['Undo','Redo'],
['Link','Unlink','Anchor'],
['Image','Flash','Table','Rule','Smiley','SpecialChar'],
['JustifyLeft','JustifyCenter','JustifyRight'],
['About'],
'/',
['Bold','Italic','Underline'],
['OrderedList','UnorderedList','-','Outdent','Indent','Blockquote'],
['FontName','FontSize'],
['TextColor','BGColor']
] ;

在页面调用,要显示设置FCKeditor对象的ToolbarSet属性

var oFCKeditor = new FCKeditor( 'MyTextarea' ) ;
oFCKeditor.BasePath = "fckeditor/" ;
oFCKeditor.Config["CustomConfigurationsPath"] ='myfckconfig.js ' ;
oFCKeditor.ToolbarSet="MYTOOLBAR";
oFCKeditor.Create();