Tiptap 3

Extensão com nós atômicos e histórico nativo do ProseMirror.

Instalação

Execute npm run build:integrations. Carregue dist/integrations/tiptap/formulix-ui.min.js antes de criar o editor e importe a extensão ESM de dist/integrations/tiptap/index.js. Para entrega com fontes e licenças, use npm run package:integrations. Use a mesma instalação Tiptap da aplicação. Versão executada: 3.32.0.

Configuração

import Formulix from './formulix/index.js';
// Adicione às extensions do editor existente:
Formulix.configure({
  servidor: 'https://api.formulix.example',
  chave: 'CHAVE_PUBLICA_DO_CLIENTE',
  idioma: 'pt-BR',
  upload: enviarPng
});
// enviarPng(blob) deve enviar o PNG e devolver uma Promise com a URL.
// Nos botões da aplicação:
editor.commands.openFormulix('formula'); // conta, grafico, quimica

Implemente enviarPng na aplicação. O callback upload é obrigatório para gráficos e desenhos. O servidor de mídia deve autenticar o usuário e validar PNG, tamanho e permissões.

API e chave

Configure a URL HTTPS da API fornecida pelo operador e a chave pública da sua conta. Cadastre o domínio do editor no painel; o domínio cadastrado cobre seus subdomínios. Os endereços dos exemplos são ilustrativos, não serviços disponíveis.

O conteúdo de prévias e inserções é enviado à API. Use somente a chave pública por domínio: nunca coloque credenciais administrativas, SMTP ou Mercado Pago no navegador. Consulte autenticação, erros e limites e privacidade.

Uso e persistência

Abra as abas pelos comandos e clique duas vezes no item para reeditar. Os nós formulixInline e formulixBloco são atômicos e guardam HTML sanitizado. Salve editor.getJSON() ou editor.getHTML(), preservando MathML, tabelas e data-* no sanitizador do servidor.

Limites conhecidos

A seleção acompanha transações enquanto o diálogo está aberto. Se o alvo for removido durante a resposta do serviço, a atualização é recusada. Somente leitura impede alterações. Colaboração remota/Yjs não foi homologada.

Verificações existentes na versão 3.32.0: quatro tipos, JSON/HTML, histórico, seleção mapeada, sanitização e somente leitura.

O clipboard OMML/RTF do Word continua específico do TinyMCE. Paridade nos adaptadores alpha, idiomas diferentes simultâneos, Firefox/WebKit e uso em dispositivos móveis ainda precisam de homologação.