Biblioteca html.php

Caminho no Gestor bibliotecas/html.php

Uma sessão de edição de HTML por DOM, guardada na global $_HTML['dom']: abre um trecho, altera elementos selecionados por classe CSS e devolve o HTML. Hoje só a configuracao.php a usa, para esconder elementos (classe escondido) nas telas de configuração; o resto do Gestor trabalha com strings pela modelo.php.

gestor_incluir_biblioteca('html');
html_iniciar(['valor' => $trecho]);          // ou ['gestor' => true] para usar $_GESTOR['pagina']
html_adicionar_classe(['consulta' => 'campo', 'classe' => 'obrigatorio']);
html_atributo(['opcao' => 'mudar', 'consulta' => 'campo', 'atributo' => 'data-id', 'valor' => '7']);
$trecho = html_finalizar();                  // ou ['gestor' => true] para gravar em $_GESTOR['pagina']

consulta é sempre um nome de classe (não um seletor CSS) e entra no XPath sem escape.

Outros efeitos colaterais:

• html_adicionar_classe() lê o class do primeiro elemento e o grava, com a classe nova, em todos os que casam: as classes próprias dos demais são substituídas.

• html_iniciar() usa mb_convert_encoding(…, 'HTML-ENTITIES'), obsoleto no PHP 8.2 (gera aviso de deprecation).

• O DOMDocument corrige o HTML: fecha tags, move elementos e envolve texto solto. O que sai pode não ser byte a byte o que entrou.

• html_beautify() aplica stripslashes() antes, o que apaga barras invertidas do conteúdo. Não tem chamadores.

Funções

html_iniciar(array|false $params = false): void

html_finalizar(array|false $params = false): string|void

html_consulta(array|false $params = false): DOMNodeList

html_atributo(array|false $params = false): string|void

html_valor(array|false $params = false): void

html_adicionar_classe(array|false $params = false): void

html_elemento(array|false $params = false): void

html_beautify(string $html): tidy