Tiptap 3

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

Instalação

npm install formulix-tiptap

Carregue formulix-tiptap/formulix-ui.min.js antes de criar o editor e importe a extensão ESM de formulix-tiptap. Use a mesma instalação Tiptap da aplicação. Versão executada: 3.32.0.

Configuração

import Formulix from 'formulix-tiptap';
// Adicione às extensions do editor existente:
Formulix.configure({
  servidor: 'https://api.formulix.com.br',
  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

A URL padrão é a do serviço oficial, https://api.formulix.com.br. A chave é opcional: sem ela, o domínio do editor usa o plano Grátis; quando o limite acaba, o diálogo mostra o link de cadastro. Cadastre o domínio no painel e escolha um plano; o domínio cadastrado cobre seus subdomínios e o site segue funcionando sem chave.

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. A colagem do Word nas outras plataformas e o uso de idiomas diferentes ao mesmo tempo ainda não são suportados.