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();