CKEditor 5

使用編輯器模型與元件的外掛。

安裝

npm install formulix-ckeditor5

建立編輯器前載入 formulix-ckeditor5/formulix-ui.min.js，以 ESM 匯入 formulix-ckeditor5。使用應用程式內同一份 ckeditor5，不要加入第二份編輯器。已測試及宣告為 peer dependency 的版本是 CKEditor 49。

整合至既有設定

import Formulix from 'formulix-ckeditor5';
const config = {
  plugins: [ /* ... */ Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.com.br',
    chave: 'YOUR_PUBLIC_KEY',
    idioma: 'zh-Hant'
  }
};

未提供 upload 回呼時使用 FileRepository 及既有上傳轉接器。自訂方式可在 formulix 傳入 upload: async blob => { /* ... */ }，上傳 PNG 後回傳 URL。這只是回呼契約，須實作身分驗證並在伺服器驗證 PNG 與大小。

API / 公開金鑰

預設網址為官方服務 https://api.formulix.com.br。金鑰為選用：未設金鑰時，編輯器網域使用免費方案；額度用盡後，對話框會顯示註冊連結。在控制台登記網域並選擇方案；登記涵蓋子網域，網站不設金鑰也能繼續運作。

預覽及插入內容會傳送至 API。瀏覽器只能放綁定網域的公開金鑰，切勿放入管理端、SMTP 或 Mercado Pago 憑證。

API · 隱私說明

儲存與限制

使用四個按鈕並按兩下項目重新編輯。儲存 editor.getData()；伺服器清理器須保留 data-formulix 包裝層、MathML、表格及 data-*。變更與歷程使用模型交易。已在 CKEditor 49 驗證四類內容、儲存/重新載入、重編輯、復原、清理及唯讀。主編輯器的授權須另行檢查；轉接器採 GPL-3.0-or-later。

Word 的 OMML/RTF 剪貼簿處理仍是 TinyMCE 專用。其他平台的 Word 貼上與同時使用多種語言暫不支援。