Biblioteca editor-texto.php

Caminho no Gestor bibliotecas/editor-texto.php

Tudo sobre o Quill, o editor de texto rico dos formulários do painel, fica aqui: a versão, as tags do editor, o CSS do conteúdo publicado e a paridade visual entre os dois. Não confundir com o editor de HTML (html-editor.php).

No painel: abrir o editor

gestor_incluir_biblioteca('editor-texto');
editor_texto_incluir();                     // ['paridade' => false] para não aplicar os tokens do projeto

editor_texto_incluir() acrescenta à página:

• o CSS e o JavaScript do Quill, pelo registro de assets externos (disco primeiro, CDN como reserva);

• interface/quill-content.css, o mesmo CSS de conteúdo que o site recebe;

• interface/editor-texto.js, que cria os editores sobre os <textarea> e mantém o campo do formulário sincronizado;

• a paridade: se o projeto tem contents/tailwindcss/browser-contract.css, as variáveis CSS (--…) dele são copiadas para dentro de .ql-editor, para o autor escrever com a fonte e as cores do site. Valores com url()/data: ou maiores que 160 caracteres ficam de fora.

A versão vem de $_GESTOR['editor-texto-versao'] ou do registro de assets externos (quill 2.0.3). O quill-content.css foi gerado para essa versão: trocar uma sem a outra faz o editor e o site desenharem diferente.

No site: o conteúdo publicado

O Quill grava a formatação em classes (ql-align-right, ql-indent-2), não em estilo inline. Sem o quill-content.css, a página publicada perde alinhamentos e recuos.

O roteador resolve isso sozinho (gestor_pagina_quill()): depois de montar a página e os widgets, editor_texto_conteudo_detectar($html) procura classes do Quill (comparando classe por classe, não por substring) e, se achar, inclui o CSS de editor_texto_assets_publicacao(). Páginas sem conteúdo do editor não carregam nada.

Detalhe

Auxiliares internos (usados pelas funções acima; raramente chamados direto): editor_texto_assets_externos_carregar(), editor_texto_versao_cdn(), editor_texto_assets_editor(), editor_texto_paridade_css().

Funções

editor_texto_assets_externos_carregar()

editor_texto_versao_cdn(): string

editor_texto_assets_editor(string $urlRaiz = '', string $versaoAsset = '', $vendorFisico = '', $vendorPublico = ''): array{css: list<string>, javascript: list<string>}

editor_texto_paridade_css(string $contrato): string

editor_texto_incluir(array $params = false): void

editor_texto_conteudo_detectar(string $html): bool

editor_texto_assets_publicacao(string $urlRaiz = '', string $versao = ''): array