FCKeditor 是一款功能強大的網頁所見即所得編輯器。本文整理了從安裝、整合到進階自訂的完整配置說明,方便開發者快速上手。
1. 下載最新版的 FCKeditor。
2. 解壓縮到站點根目錄中名為 FCKeditor 的資料夾(名稱必須為 FCKeditor,因為設定檔已以此名稱標示位置)。
3. 完成後即可使用,若要查看示範,可造訪 https://(你的網站)/FCKeditor/_samples/default.html。
補充:FCKeditor 也可放在其他資料夾,若使用不同名稱,請修改設定檔中的 BasePath 參數,例如 oFCKeditor.BasePath="/Components/fckeditor/";。此外,資料夾中所有以底線開頭的檔案與資料夾皆為可選,可安全地從正式發布中移除。
目前版本僅提供 JavaScript 式整合。首先在頁面的 HEAD 段引入整合模組:
<script type="text/javascript" src="/fckeditor/fckeditor.js"></script>
接著有兩種建立編輯器的方式:
方法一(建議):在 FORM 標籤內需要插入編輯器的地方置入:
<script type="text/javascript">
var oFCKeditor = new FCKeditor( 'FCKeditor1' ) ;
oFCKeditor.Create() ;
</script>
方法二(不建議):在頁面 onload 事件中,以 ReplaceTextarea() 方法替換既有的 TEXTAREA 標籤。
構造器:FCKeditor( instanceName[, width, height, toolbarSet, value] ),參數依序為實例名稱、寬度、高度、工具列集合名稱與初始內容。
常用屬性包含 instanceName、width(預設 100%)、height(預設 200)、ToolbarSet(預設 Default)、value、BasePath(預設 /fckeditor/,建議使用相對於網站根的絕對路徑並以 / 結尾)、CheckBrowser 與 DisplayErrors 等。
集合:Config[Key]=value,可更改設定中某項的值,例如 oFCKeditor.Config["DefaultLanguage"]="zh-cn";。
方法:Create() 建立並輸出編輯器;ReplaceTextarea(TextAreaName) 以編輯器替換對應的文本框。
FCKeditor 提供一套用以自訂外觀、特性與行為的設定,主設定檔為 fckconfig.js,採用 JavaScript 語法。你可以直接編輯主設定檔,或自訂獨立設定檔,並在建立編輯器時以 CustomConfigurationsPath 指定,例如 oFCKeditor.Config['CustomConfigurationsPath'] = '/myconfig.js';。修改設定後,記得清除瀏覽器快取才能看到效果。
主要設定選項包含:AutoDetectLanguage(自動偵測語言)、DefaultLanguage(預設語言)、EditorAreaCss(編輯區樣式表)、FontNames/FontSizes/FontColors(字型與顏色清單)、ForcePasteAsPlainText(強制貼上為純文字)、FullPage(是否允許編輯整個 HTML)、ImageBrowser/LinkBrowser(是否允許瀏覽與上傳)、SkinPath(面板主題路徑)、ToolbarSets、TabSpaces(Tab 產生的空格數)等,可依專案需求逐一調整。
樣式工具列中的預定義樣式由 XML 檔定義,預設位於 FCKeditor 根目錄的 fckstyles.xml。每個 <Style> 標籤定義一種樣式,name 為下拉清單顯示的名稱,element 指定適用的對象。由於 FCKeditor 的樣式具有情境感知特性,選取不同對象時,只會顯示針對該類對象定義的樣式。
FCKeditor 內建兩種拼字檢查工具:預設的 ieSpell(需客戶端下載安裝),以及由 PHP 撰寫的 SpellPager(需服務器支援 PHP)。此外,為提升腳本載入效率,它會移除註解與無意義空白來壓縮腳本,並在 _Packager 資料夾中提供專門的壓縮工具,方便你在發布前縮小檔案。
若需要新增語言,只要複製 en.js 並在其基礎上翻譯即可。語言名稱與對應的腳本檔名須遵循 RFC 3066 標準並使用小寫(如 pt.js),若要區分地區,可在語系縮寫後加上橫線與國家縮寫。建立好新語言後,還需在 edit/lang/fcklanguagemanager.js 中新增對應條目,並將檔案儲存為 UTF-8 格式。系統會自動偵測客戶端語系與國別,套用合適的介面語言。
在 ASP.NET 中使用時,先把 FCKeditor 加入工具箱、拖曳控件到頁面並指定名稱,其所有屬性既可於程式碼中使用,也能作為控件的屬性直接設定。POSTBACK 後可利用控件的 value 屬性取得資料。由於 ASP.NET 預設不允許提交含 HTML 與 JavaScript 的內容,因此使用 FCKeditor 的頁面須將 ValidateRequest 設為 false(<%@page validaterequest="false" %>)。
要動態設定上傳圖片的路徑,可在 JavaScript 中修改 FCKConfig.ImageBrowserURL 的值加上查詢參數(如 "?Path=/UploadFile"),再於 connector.aspx 的 OnInit 中,依 QueryString 動態設定 Session["FCKeditor:UserFilesPath"]。
關於上傳與瀏覽權限,建議先在 fckconfig.js 中把所有 LinkBrowser、ImageBrowser、FlashBrowser 及對應的 Upload 選項全設為 false,再在建立編輯器時,依使用者權限(例如判斷是否為管理員)有條件地開啟這些功能,藉此兼顧安全與彈性。
・適時開啟編輯器:頁面載入時先建立隱藏的 Textarea,待使用者點擊「Open Editor」按鈕時,再以 ReplaceTextarea() 動態建立 FCKeditor,可改善使用者體驗並消除載入對頁面速度的影響。
・善用 API:FCKeditor 提供 GetLength()、InsertHTML()、ExecuteCommand() 等豐富 API,可用於資料驗證、插入內容與執行內嵌操作。
・外聯工具列:自 2.3 版起支援多個編輯區共用一個工具列,只要定義一個工具列容器並將 ToolbarLocation 設為 "Out:容器ID" 即可,免去逐一建立的麻煩。