Tiptap 3

使用 ProseMirror 原子节点与原生历史记录的扩展。

安装

运行 npm run build:integrations，在创建编辑器前加载 dist/integrations/tiptap/formulix-ui.min.js，以 ESM 导入 dist/integrations/tiptap/index.js，加入现有 extensions。带源码和许可的交付使用 npm run package:integrations。使用应用中的同一份 Tiptap。已运行版本为 3.32.0。

配置

import Formulix from './formulix/index.js';
Formulix.configure({
  servidor: 'https://api.formulix.example',
  chave: 'YOUR_PUBLIC_KEY',
  idioma: 'zh-Hans',
  upload: uploadPng
});
editor.commands.openFormulix('formula'); // conta, grafico, quimica

在应用中实现 uploadPng(blob)：上传 PNG，返回解析为 URL 的 Promise。图像和绘图必须提供 upload 回调；媒体服务器需验证用户、PNG、大小和权限。

API / 公开密钥

设置运营方提供的 HTTPS API 地址和账户公开密钥，在控制台登记编辑器域名；其子域名也受覆盖。https://api.formulix.example 和 YOUR_PUBLIC_KEY 均为占位示例，不是真实服务地址或密钥。

预览和插入的内容会发送至 API。浏览器中只使用绑定域名的公开密钥，切勿放入管理端、SMTP 或 Mercado Pago 凭据。

API · 隐私说明 — 翻译草案

保存与限制

openFormulix 支持 formula / conta / grafico / quimica；双击重新编辑。formulixInline 和 formulixBloco 是保存已清理 HTML 的原子节点。保存 editor.getJSON() 或 editor.getHTML()，服务端清理时保留 MathML、表格与 data-*。对话框打开期间选区随事务映射；若 API 响应前目标已删除，则拒绝更新；只读模式禁止修改。远程协作/Yjs 尚未验证。3.32.0 已验证四类内容、JSON/HTML、历史记录、选区映射、清理及只读。

Word 的 OMML/RTF 剪贴板处理仍为 TinyMCE 专有路径。Alpha 适配器的同等粘贴能力、多语言同时使用、Firefox/WebKit 和移动端均有待验证。