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-Hans'
  }
};

未提供 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 粘贴和同时使用多种语言暂不支持。