萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Dreamweaver 教學

FCKeditor 整合指南:安裝、JS 整合、配置選項與自定義樣式/拼寫檢查

FCKeditor 簡介

FCKeditor(現更名為 CKEditor 4/5)是經典的開源富文本編輯器,支援 IE6+/Firefox/Safari/Opera,輸出 XHTML 相容代碼,提供工具列、圖片上傳、樣式下拉、拼寫檢查等完整功能。本文基於 FCKeditor 2.x 架構說明整合細節。

安裝步驟

  1. 下載最新版 FCKeditor。
  2. 解壓縮至站點根目錄下名為 FCKeditor 的資料夾(名稱固定,因配置檔預設路徑硬編碼)。
  3. 驗證安裝:瀏覽 https://your-site/FCKeditor/_samples/default.html 查看示範頁。
提示: 若安裝路徑不同,需修改配置檔 fckconfig.js 中的 FCKConfig.BasePath 參數(如 /CustomPath/fckeditor/),結尾必須帶斜線。底線開頭資料夾/檔案(_samples, _source, _test 等)為開發/測試用,部署時可安全刪除。

JavaScript 整合兩種方式

方式一:內聯建立(推薦)

<script type="text/javascript" src="/FCKeditor/fckeditor.js"></script>
<form>
  <script type="text/javascript">
    var oFCKeditor = new FCKeditor('FCKeditor1');
    oFCKeditor.Create();
  </script>
</form>

方式二:替換現有 TEXTAREA(不建議)

<script type="text/javascript">
  window.onload = function() {
    var oFCKeditor = new FCKeditor('MyTextarea');
    oFCKeditor.ReplaceTextarea();
  };
</script>
<textarea id="MyTextarea" name="MyTextarea">初始內容</textarea>

FCKeditor 建構子與屬性完整參考

參數/屬性說明預設值
instanceName編輯器唯一實例名(相當於 ID)必填
width寬度(像素/百分比)100%
height高度(像素)200
toolbarSet工具列集合名稱(定義於 fckconfig.js)Default
value初始化 HTML 內容空字串
BasePath編輯器基底路徑(建議站點根目錄相對路徑,以 / 結尾)/FCKeditor/
CheckBrowser啟動前檢查瀏覽器相容性true
DisplayErrors顯示錯誤提示true
Config[Key]動態覆寫配置項(如 oFCKeditor.Config['DefaultLanguage']='zh-cn')-

核心方法

  • Create():建立並輸出編輯器 HTML。
  • ReplaceTextarea(textareaName):以編輯器取代指定 name 的 textarea。

配置檔 fckconfig.js 關鍵選項

  • AutoDetectLanguage:自動偵測語言 (true/false)
  • BaseHref:相對連結基底網址
  • ContentLangDirection:預設文字方向 (ltr/rtl)
  • ContextMenu:右鍵選單項目陣列
  • CustomConfigurationsPath:自定義配置檔路徑
  • Debug:開啟除錯模式
  • DefaultLanguage:預設語言代碼
  • EditorAreaCSS:編輯區域樣式表檔案
  • EnableSourceXHTML / EnableXHTML:輸出 XHTML 而非 HTML
  • FillEmptyBlocks:空區塊填入 &nbsp;
  • FontColors/FontFormats/FontNames/FontSizes:字體/大小/格式/顏色下拉選單內容
  • ForcePasteAsPlainText:強制貼上為純文字
  • ImageBrowser / LinkBrowser:啟用圖片/連結瀏覽伺服器功能
  • ImageBrowserURL / LinkBrowserURL:瀏覽伺服器的後端處理網址
  • Plugins / PluginsPath:外掛註冊與路徑
  • SkinPath:皮膚資料夾位置
  • SmileyImages / SmileyPath / SmileyColumns:表情符號設定
  • SpellChecker:拼寫檢查器 (ieSpell/SpellerPages)
  • StartupFocus:啟動時聚焦編輯器
  • StylesXmlPath:XML 定義樣式下拉清單檔案位置
  • ToolbarCanCollapse / ToolbarStartExpanded:工具列摺疊/展開行為
  • UseBROnCarriageReturn:Enter 產生 <br> 而非 <p>/<div>

自定義樣式下拉清單 (fckstyles.xml)

<?xml version="1.0" encoding="utf-8"?>
<Styles>
  <Style name="My Image" element="img">
    <Attribute name="style" value="padding: 5px" />
    <Attribute name="border" value="2" />
  </Style>
  <Style name="Italic" element="em" />
  <Style name="Title" element="span">
    <Attribute name="class" value="Title" />
  </Style>
  <Style name="Title H3" element="h3" />
</Styles>

每個 <Style> 定義一個樣式:name 顯示在下拉選單,element 限定適用標籤(上下文敏感,選取不同元素顯示不同可用樣式)。

拼寫檢查設定

  • ieSpell(預設): 需用戶端安裝 ieSpell 軟體,無伺服器需求。
  • SpellerPages (PHP): 伺服器端 PHP 腳本,需 PHP 環境支援,無用戶端安裝需求。
  • 切換方式:修改 fckconfig.js 中 FCKConfig.SpellChecker = 'SpellerPages'; 並設定對應 URL。

腳本壓縮優化

FCKeditor 採用移除註解/空白、縮短變數名、合併檔案等方式壓縮核心腳本,減少下載體積。生產環境請使用壓縮版 (fckeditor.js 已壓縮),開發除錯可用 _source 目錄下原始碼。

遷移至 CKEditor 4/5 建議

FCKeditor 已停止維護(2009 年末釋出 2.6.6 為最終版)。現代專案請遷移至:

  • CKEditor 4: 架構相容、支援現代瀏覽器、持續安全更新、相同 API 風格,遷移成本低。
  • CKEditor 5: 全新模組化架構、支援協同編輯、React/Vue/Angular 整合、TypeScript 原生、現代打包工具友善,但 API 完全不同,需重寫整合層。
copyright © 萬盛學電腦網 all rights reserved