CKEditor 5

Plugin com widgets e transações do modelo do editor.

Instalação

Execute npm run build:integrations e copie dist/integrations/ckeditor5/ para a aplicação. Para entrega com fontes e licenças, use npm run package:integrations. Carregue formulix-ui.min.js antes de criar o editor e importe index.js como ESM.

Use a mesma instalação ckeditor5 da aplicação; não inclua outra cópia do editor. Versão testada e declarada como peer dependency: CKEditor 49.

Configuração

import Formulix from './formulix/index.js';
// Mescle com a configuração existente do ClassicEditor.
const configuracao = {
  plugins: [ /* plugins da aplicação, */ Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.example',
    chave: 'CHAVE_PUBLICA_DO_CLIENTE',
    idioma: 'pt-BR'
  }
};

Sem callback upload, usa FileRepository e o upload adapter já configurado. Para upload próprio, passe upload: async blob => { /* enviar PNG e retornar URL */ } em formulix. Esse trecho descreve o contrato; implemente envio autenticado e validação de PNG/tamanho no servidor.

API e chave

Configure a URL HTTPS da API fornecida pelo operador e a chave pública da sua conta. Cadastre o domínio do editor no painel; o domínio cadastrado cobre seus subdomínios. Os endereços dos exemplos são ilustrativos, não serviços disponíveis.

O conteúdo de prévias e inserções é enviado à API. Use somente a chave pública por domínio: nunca coloque credenciais administrativas, SMTP ou Mercado Pago no navegador. Consulte autenticação, erros e limites e privacidade.

Uso e persistência

Use os quatro botões e clique duas vezes no item para reeditar. Salve editor.getData(). Preserve wrappers data-formulix, MathML, tabelas e atributos data-* no sanitizador do servidor. Alterações e histórico usam transações do modelo.

Limites conhecidos

Testado com CKEditor 49: quatro tipos, salvar/recarregar, reedição, desfazer, sanitização e somente leitura. Revise separadamente a licença do editor anfitrião; o adaptador é GPL-3.0-or-later.

O clipboard OMML/RTF do Word continua específico do TinyMCE. Paridade nos adaptadores alpha, idiomas diferentes simultâneos, Firefox/WebKit e uso em dispositivos móveis ainda precisam de homologação.