Biblioteca html-editor.php

Caminho no Gestor bibliotecas/html-editor.php

O editor que aparece nos formulários de páginas, layouts, componentes, templates, publicações, menus, galerias, formulários e índices (cerca de 30 chamadas em 12 módulos). O servidor monta a tela e responde ao AJAX; a edição em si roda no navegador (interface/html-editor.js e html-editor-interface.js).

Abrir o editor: html_editor_componente()

gestor_incluir_biblioteca('html-editor');
$_GESTOR['pagina'] = modelo_var_troca($_GESTOR['pagina'], '#html-editor#', html_editor_componente([
    'editar' => true,
    'modulo' => $modulo,                    // o JSON do módulo
    'alvo' => 'paginas',                    // escolhe modelos e prompts de IA
    'css_precompiled' => $registro['css_precompiled'],
    'layout_id' => $registro['layout_id'],  // para pré-visualizar com a cascata do layout
]));

Parâmetros: editar / adicionarEditar (edição, ou adição que já edita HTML e CSS), modulo, alvo, alvos_modelos (alvos extras de modelos), publisher e publisherPage (controles de variáveis do publicador, html_editor_publisher_controls()), css_precompiled e layout_id.

A tela tem:

• código HTML e CSS em CodeMirror (assets externos);

• visual e pré-visualização num iframe com o Tailwind rodando no navegador (versão do registro, html_editor_tailwind_browser_version()), nos tamanhos desktop, tablet e celular; o CSS de base é a mesma cascata do site: pré-compilado do layout, do recurso e o CSS autoral do layout (html_editor_css_precompiled_baseline(), html_editor_layout_css_autoral(), html_editor_css_precompiled_concatenar()). Trocar o layout no formulário recarrega essa cascata (html-editor-layout-css);

• modelos (templates por alvo) para começar uma página;

• variáveis @[[…]]@ e widgets mostrados como caixas no visual, com o conteúdo real renderizado sob demanda;

• assistente de IA (ia.php), aba SEO & Compartilhamento nas páginas, e o histórico de backups do HTML/CSS para restaurar.

O que o navegador compila vai para css_compiled ao salvar, com a assinatura de procedência (recursos).

AJAX: html_editor_ajax_interface()

Chamada pela interface.php quando a biblioteca está entre as do módulo. Primeiro passa por ia_ajax_interface() e depois despacha pela ajax-opcao:

Tokens do tema para a IA

Para a IA usar as cores e fontes do site em vez de inventar, o editor resume o contrato Tailwind do projeto (contents/tailwindcss/browser-contract.css, html_editor_tailwind_browser_contract()) num bloco {{theme_tokens}} de até ~1,5 KB (teto 2 KB), priorizando cor, fonte e espaçamento: html_editor_ia_tokens_tema_compilar(), com html_editor_ia_tokens_tema_limite(), html_editor_ia_tokens_tema_namespaces(), html_editor_ia_tokens_tema_valor_util(), html_editor_ia_tokens_tema_bloco(), html_editor_ia_tokens_tema_componentes(), html_editor_ia_css_classes_resumir() e html_editor_ia_extrair_tokens_tema(). O modo de IA recebe o bloco no marcador próprio (html_editor_ia_theme_tokens_marcador(), html_editor_ia_modo_theme_tokens_aplicar()).

Inclusões e filtros

• html_editor_include(['js_vars' => …]) inclui o editor visual e suas dependências; os filtros html-editor.html_editor_include.projectJS e html-editor.html_editor_include.imagepickJS (hooks) deixam o projeto trocar o JS do projeto e o seletor de imagens.

• html_editor_assets_registro() carrega sob demanda o registro de assets externos.

• html_editor_tailwind_browser_contract() lê o contrato de tema do projeto (contents/tailwindcss/browser-contract.css, que prevalece sobre o do core) entregue ao Tailwind do navegador.

Funções

html_editor_publisher_controls(array $params = false)

html_editor_tailwind_browser_version(): string

html_editor_assets_registro(): array

html_editor_tailwind_browser_contract(): string

html_editor_ia_tokens_tema_limite(): int

html_editor_ia_tokens_tema_namespaces(): array

html_editor_ia_tokens_tema_valor_util(string $valor): bool

html_editor_ia_tokens_tema_bloco(string $css): string

html_editor_ia_tokens_tema_componentes(string $css): array

html_editor_ia_css_classes_resumir(string $css, int|null $limiteBytes = null): string

html_editor_ia_tokens_tema_compilar(string $css, int|null $limiteBytes = null): string

html_editor_ia_theme_tokens_marcador(): string

html_editor_ia_modo_theme_tokens_aplicar(string $modo, string $theme_tokens): string

html_editor_ia_extrair_tokens_tema(string|null $caminhoContrato = null, int|null $limiteBytes = null): string

html_editor_css_precompiled_baseline(array $params = false): string

html_editor_layout_css_autoral(string $layout_id): string

html_editor_css_precompiled_concatenar(string $layout, string $recurso): string

html_editor_componente($params = false)

html_editor_include($params = false)

html_editor_ajax_interface(array $params = false)

html_editor_ajax_layout_css()

html_editor_var_pattern()

html_editor_var_box($marker, $rendered, $tipo)

html_editor_render_widget_signature($signature)

html_editor_widget_renderizar($sig): array

html_editor_widget_js_modulos(): array

html_editor_resolver_var($id)

html_editor_boxes_widgets($html)

html_editor_resolver_variaveis($html)

html_editor_boxes_variaveis($html)

html_editor_ajax_render_vars()

html_editor_ajax_widget_render()

html_editor_ajax_widget_types()

html_editor_ajax_widgets_list()

html_editor_widgets_buscar(array $params = array()): array

html_editor_ajax_templates_load()

html_editor_ajax_ia_requests()

Widgets e prévias responsivas

html_editor_widget_renderizar renderiza um widget declarado e retorna um array com html e css; html_editor_widget_js_modulos devolve um mapa módulo => true para widgets ativos com arquivo .widget.js. O Dashboard coleta CSS, head e scripts registrados durante a renderização e restaura o contexto temporário. O editor visual usa altura baseada no viewport, calc(100vh - 220px), nos modais Tailwind de edição/visualização. Widgets precisam dos estilos de template, registro e tema na prévia isolada. Veja Dashboard para a ordem das folhas.