Tiptap 3

Extension avec nœuds atomiques et historique natif de ProseMirror.

Installation

npm install formulix-tiptap

Chargez formulix-tiptap/formulix-ui.min.js avant de créer l’éditeur et importez l’extension ESM de formulix-tiptap. Conservez la même installation Tiptap que l’application. Version exécutée : 3.32.0.

Configuration

Ajoutez l’extension à l’éditeur existant. Reliez vos boutons à openFormulix avec les identifiants formula, conta, grafico ou quimica.

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

Implémentez uploadPng(blob) : la fonction doit envoyer le PNG et renvoyer une Promise avec l’URL. Le callback upload est obligatoire pour graphiques et dessins. Le serveur de médias doit authentifier l’utilisateur et valider le PNG, la taille et les permissions.

API et clé publique

L’URL par défaut est celle du service officiel, https://api.formulix.com.br. La clé est facultative : sans elle, le domaine de l’éditeur utilise le forfait Gratuit ; quand le quota est épuisé, la boîte de dialogue affiche un lien d’inscription. Enregistrez le domaine dans le tableau de bord et choisissez un forfait ; l’enregistrement couvre ses sous-domaines et le site continue de fonctionner sans clé.

Le contenu des aperçus et insertions est envoyé à l’API. Utilisez uniquement la clé publique liée au domaine ; ne placez jamais d’identifiants d’administration, SMTP ou Mercado Pago dans le navigateur. Consultez l’authentification, les erreurs et les limites et la politique de confidentialité.

Utilisation et conservation

Ouvrez les onglets par les commandes et double-cliquez sur l’élément pour le modifier. Les nœuds formulixInline et formulixBloco sont atomiques et gardent du HTML filtré. Enregistrez editor.getJSON() ou editor.getHTML() en préservant MathML, tableaux et data-* dans le filtre du serveur.

Limites connues

La sélection suit les transactions tant que la boîte de dialogue reste ouverte. Si la cible disparaît pendant la réponse du service, la mise à jour est refusée. La lecture seule empêche les modifications. La collaboration distante/Yjs n’a pas été validée.

Vérifié en 3.32.0 : quatre types, JSON/HTML, historique, suivi de sélection, filtrage et lecture seule.

Le traitement du presse-papiers OMML/RTF de Word reste propre à TinyMCE. Le collage depuis Word sur les autres plateformes et l’usage simultané de plusieurs langues ne sont pas encore pris en charge.