html.php library

Path in the Gestor bibliotecas/html.php

A DOM editing session over HTML, kept in the $_HTML['dom'] global: it opens a snippet, changes elements selected by CSS class and returns the HTML. Today only configuracao.php uses it, to hide elements (the escondido class) on configuration screens; the rest of the Gestor works with strings through modelo.php.

gestor_incluir_biblioteca('html');
html_iniciar(['valor' => $snippet]);         // or ['gestor' => true] to use $_GESTOR['pagina']
html_adicionar_classe(['consulta' => 'field', 'classe' => 'required']);
html_atributo(['opcao' => 'mudar', 'consulta' => 'field', 'atributo' => 'data-id', 'valor' => '7']);
$snippet = html_finalizar();                 // or ['gestor' => true] to write into $_GESTOR['pagina']

consulta is always a class name (not a CSS selector) and goes into the XPath unescaped.

Other side effects:

• html_adicionar_classe() reads the class of the first element and writes it, with the new class, to every matching element: the other elements' own classes are replaced.

• html_iniciar() uses mb_convert_encoding(…, 'HTML-ENTITIES'), deprecated in PHP 8.2 (it raises a deprecation notice).

• DOMDocument repairs the HTML: it closes tags, moves elements and wraps loose text. The output may not match the input byte for byte.

• html_beautify() applies stripslashes() first, which deletes backslashes from the content. It has no callers.

Functions

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