Tiptap 3

Extensión con nodos atómicos e historial nativo de ProseMirror.

Instalación

npm install formulix-tiptap

Cargue formulix-tiptap/formulix-ui.min.js antes de crear el editor e importe la extensión ESM de formulix-tiptap. Utilice la misma instalación Tiptap de su aplicación. Versión ejecutada: 3.32.0.

Configuración

Añada la extensión al editor existente; conecte los botones de su aplicación a openFormulix con los identificadores formula, conta, grafico y quimica.

import Formulix from 'formulix-tiptap';
Formulix.configure({
  servidor: 'https://api.formulix.com.br',
  chave: 'YOUR_PUBLIC_KEY',
  idioma: 'es-419',
  upload: uploadPng
});
editor.commands.openFormulix('formula'); // conta, grafico, quimica

Implemente uploadPng(blob) en su aplicación: debe cargar el PNG y devolver una Promise con la URL. El callback upload es obligatorio para gráficas y dibujos. El servidor de archivos debe autenticar al usuario y validar PNG, tamaño y permisos.

API y clave pública

La URL predeterminada es la del servicio oficial, https://api.formulix.com.br. La clave es opcional: sin ella, el dominio del editor usa el plan Gratuito; cuando se agota el límite, el diálogo muestra el enlace de registro. Registre el dominio en el panel y elija un plan; el registro incluye sus subdominios y el sitio sigue funcionando sin clave.

Las vistas previas y las inserciones envían contenido a la API. Use únicamente la clave pública por dominio; nunca incluya credenciales administrativas, SMTP o Mercado Pago en el navegador. Consulte autenticación, errores y límites y la política de privacidad.

Uso y persistencia

Abra las pestañas mediante los comandos y haga doble clic en el elemento para volver a editarlo. Los nodos formulixInline y formulixBloco son atómicos y guardan HTML filtrado. Guarde editor.getJSON() o editor.getHTML(), conservando MathML, tablas y data-* en el filtro del servidor.

Límites conocidos

La selección sigue las transacciones mientras el diálogo está abierto. Si el destino desaparece mientras responde el servicio, se rechaza la actualización. El modo de solo lectura impide cambios. La colaboración remota/Yjs no está validada.

Verificado en 3.32.0: cuatro tipos, JSON/HTML, historial, seguimiento de selección, filtrado y solo lectura.

El acceso al portapapeles OMML/RTF de Word sigue siendo específico de TinyMCE. El pegado desde Word en las demás plataformas y el uso de varios idiomas a la vez aún no son compatibles.