Tiptap 3

Estensione con nodi atomici e cronologia nativa ProseMirror.

Installazione

Esegui npm run build:integrations. Carica dist/integrations/tiptap/formulix-ui.min.js prima di creare l’editor e importa l’estensione ESM da dist/integrations/tiptap/index.js. Per sorgenti e licenze usa npm run package:integrations. Usa la stessa installazione Tiptap dell’applicazione. Versione eseguita: 3.32.0.

Configurazione

// Aggiungi alle extensions dell’editor esistente:
import Formulix from './formulix/index.js';
Formulix.configure({
  servidor: 'https://api.formulix.example',
  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

Configura l’URL HTTPS fornito dal gestore e la chiave pubblica del tuo account. Registra nel pannello il dominio dell’editor: comprende anche i sottodomini. https://api.formulix.example e YOUR_PUBLIC_KEY sono segnaposto, non un servizio disponibile o una chiave reale.

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 la bozza 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. Restano da convalidare la stessa gestione dell’incolla negli adattatori alpha, più lingue simultanee, Firefox/WebKit e dispositivi mobili.