Tiptap 3

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

Instalación

Ejecute npm run build:integrations. Cargue dist/integrations/tiptap/formulix-ui.min.js antes de crear el editor e importe la extensión ESM de dist/integrations/tiptap/index.js. Para distribuir fuentes y licencias, use npm run package:integrations. 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/index.js';
Formulix.configure({
  servidor: 'https://api.formulix.example',
  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

Configure la URL HTTPS de la API facilitada por el operador y la clave pública de su cuenta. Registre en el panel el dominio del editor; incluye sus subdominios. https://api.formulix.example y YOUR_PUBLIC_KEY son placeholders: no son un servicio disponible ni una clave real.

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 el borrador 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. La equivalencia en los adaptadores alpha, varios idiomas simultáneos, Firefox/WebKit y los dispositivos móviles aún requieren validación.