Biblioteca controles.php

Caminho no Gestor bibliotecas/controles.php

Os ajudantes retornam HTML; o JavaScript adiciona comportamento preservando o envio nativo. As convenções do painel descrevem classes, máscaras, selects flutuantes e mensagens formatadas.

• controles_textos: Lê as variáveis globais controles-* para o JS.

• controles_incluir: Enfileira CSS, runtime, máscaras e textos uma vez por página.

• controles_esc: Escapa valores com ENT_QUOTES e UTF-8.

• controles_select: Cria select nativo, opções/grupos, busca, múltiplo e configuração AJAX.

• controles_chave: Cria checkbox; pode incluir valor oculto zero quando desligado.

• controles_abas: Escapa rótulos; conteúdo já pronto é HTML não escapado.

• controles_atributos: Valida nomes; true vira atributo sem valor, false/null são omitidos.

• controles_campo: Agrupa rótulo, ajuda, erro e aria-describedby; tipos incluem texto, área, select e chave.

• controles_botao: Gera botão com variante e ícone Lucide; escapa o rótulo.

Runtime dos controles

O observador interno observarSelects monta selects inseridos depois da carga e reconstrói a casca de controles clonados, cujos eventos não são copiados por cloneNode. Selects dentro de template ficam de fora até serem inseridos no documento. A seleção conserva o select nativo para enviar o formulário.

c2fControles.formatado permite somente b, strong, i, em, u, br e code, sem atributos. As máscaras percentual e moeda são carregadas por controles_incluir: exibem números no padrão pt-BR e enviam decimais com ponto no evento formdata; percentual limita 0–100 com duas casas.

Referência extraída de funções

controles_textos()

controles_incluir()

controles_esc($valor)

controles_select(array $params)

controles_chave(array $params)

controles_abas(array $abas, $ativa = null)

controles_atributos(array $atributos)

controles_campo(array $p)

controles_botao(array $p)