Tiptap 3

Estensione con nodi atomici e cronologia nativa ProseMirror.

Installazione

npm install formulix-tiptap

Carica formulix-tiptap/formulix-ui.min.js prima di creare l’editor e importa l’estensione ESM da formulix-tiptap. Usa la stessa installazione Tiptap dell’applicazione. Versione eseguita: 3.32.0.

Configurazione

// Aggiungi alle extensions dell’editor esistente:
import Formulix from 'formulix-tiptap';
Formulix.configure({
  servidor: 'https://api.formulix.com.br',
  chave: 'YOUR_PUBLIC_KEY',
  idioma: 'it',
  upload: uploadPng
});
// uploadPng(blob): Promise<URL>
editor.commands.openFormulix('formula'); // conta, grafico, quimica

Implementa uploadPng nell’applicazione: deve caricare il PNG e restituire una Promise con l’URL. Il callback upload è obbligatorio per grafici e disegni. Il server media deve autenticare l’utente e verificare PNG, dimensione e permessi.

API e chiave pubblica

L’URL predefinito è quello del servizio ufficiale, https://api.formulix.com.br. La chiave è facoltativa: senza, il dominio dell’editor usa il piano Gratuito; quando il limite si esaurisce, la finestra mostra il link di registrazione. Registra il dominio nel pannello e scegli un piano; la registrazione comprende i sottodomini e il sito continua a funzionare senza chiave.

Anteprime e inserimenti inviano contenuti all’API. Nel browser usa solo la chiave pubblica legata al dominio, mai credenziali amministrative, SMTP o Mercado Pago. Consulta autenticazione, errori e limiti e l’informativa sulla privacy.

Uso e persistenza

Apri le schede tramite comandi e fai doppio clic sull’elemento per modificarlo. I nodi formulixInline e formulixBloco sono atomici e conservano HTML sanitizzato. Salva editor.getJSON() o editor.getHTML(), preservando MathML, tabelle e data-* nel sanitizzatore del server.

Limiti noti

La selezione segue le transazioni mentre il dialogo è aperto. Se il contenuto di destinazione viene rimosso durante la risposta del servizio, l’aggiornamento viene rifiutato. La sola lettura impedisce modifiche. Collaborazione remota/Yjs non convalidata.

Verifiche esistenti nella 3.32.0: quattro tipi, JSON/HTML, cronologia, selezione aggiornata, sanitizzazione e sola lettura.

Il percorso degli appunti OMML/RTF di Word resta specifico di TinyMCE. L’incolla da Word sulle altre piattaforme e l’uso di più lingue insieme non sono ancora supportati.