Documentation Index
Fetch the complete documentation index at: https://docs-fw.madbuilder.com.br/llms.txt
Use this file to discover all available pages before exploring further.
__construct
Construtor da classe TEntry.
Parâmetros:
Nome do campo que será utilizado no formulário.
$cnpj = new TEntry('cnpj');
setValue
Define o valor do campo.
Parâmetros:
Uma string contendo o valor do campo.
$cnpj = new TEntry('cnpj');
$cnpj->setValue('00.000.000/0000-00');
setMask
Define a máscara do campo.
Parâmetros:
Máscara para os dados de entrada.
(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.
$cpf = new TEntry('cpf');
$cpf->setMask('000.000.000-00');
setNumericMask
Define a máscara numérica do campo.
Parâmetros:
Número de casas decimais.
Separador para o ponto decimal.
(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.
(Opcional) Booleano indicando se a máscara deve ser invertida.
(Opcional) Booleano indicando se valores negativos são permitidos.
$preco = new TEntry('preco');
$preco->setNumericMask(2, ',', '.');
$preco = new TEntry('preco');
$preco->setNumericMask(2, ',', '.', true, true, false);
setCompletion
Define as opções de preenchimento automático para o campo.
Parâmetros:
Array de opções para conclusão.
$genero = new TEntry('genero');
$genero->setCompletion(['Feminino', 'Masculino', 'Outro', 'Prefiro não dizer']);
setMaxLength
Define o comprimento máximo do campo.
Parâmetros:
Comprimento máximo do campo.
$rg = new TEntry('rg');
$rg->setMaxLength(10);
setMinLength
Define o comprimento mínimo para pesquisa (requer uso do ‘setCompletion’).
Parâmetros:
Comprimento mínimo para pesquisa.
$genero = new TEntry('genero');
$genero->setCompletion(['Feminino', 'Masculino', 'Outro', 'Prefiro não dizer']);
$genero->setMinLength(3);
setExitAction
Define a ação a ser executada quando o usuário sair do campo.
Parâmetros:
Exemplo de código:
$cep = new TEntry('cep');
$cep->setExitAction(new TAction(['NomeClasseDeControle', 'onExitCampo']))
public static function onExitCampo($param = null)
{
new TMessage('info', print_r($param, true));
}
setExitFunction
Define a função JavaScript a ser executada quando o usuário sair do campo.
Parâmetros:
Exemplo de código:
$toast = new TEntry('usuario');
$toast->setExitFunction('alert("Você saiu do campo Nome de Usuário.");');
enableToggleVisibility
Ativa ou desativa a opção de alternar a visibilidade do campo.
Parâmetros:
(Opcional) Booleano indicando se a opção deve ser ativada.
$cnpj = new TEntry('cnpj');
$cnpj->setValue('00.000.000/0000-00');
$cnpj->setSize(200);
$cnpj->enableToggleVisibility();
setDelimiter
Define o delimitador de conclusão automática (permite múltiplas inserções).
Parâmetros:
Delimitador de conclusão automática.
$genero = new TEntry('genero');
$genero->setCompletion(['Feminino', 'Masculino', 'Outro', 'Prefiro não dizer']);
$genero->setDelimiter(',');
disableAutoComplete
Desativa o preenchimento automático do navegador.
Exemplo de código:
$senha = new TEntry('senha');
$senha->disableAutoComplete();
forceLowerCase
Força letras minúsculas no campo.
Exemplo de código:
$codigo = new TEntry('codigo');
$codigo->forceLowerCase();
forceUpperCase
Força letras maiúsculas no campo.
Exemplo de código:
$placaVeiculo = new TEntry('placaVeiculo');
$placaVeiculo->forceUpperCase();
setInnerIcon
Define o ícone interno do campo.
Parâmetros:
Objeto TImage representando o ícone.
(Opcional) Lado do ícone.
$nomeUsuario = new TEntry('nomeUsuario');
$icone = new TImage('fas fa-user');
$nomeUsuario->setInnerIcon($icone, 'left');
getPostData
Obtém os dados enviados no POST (transformará valores de acordo com a máscara do banco de dados).
Exemplo de código (com máscara):
$cpf = new TEntry('cpf');
$cpf->setMask('000.000.000-00', true);
$dadosPostados = $cpf->getPostData();
$preco = new TEntry('preco');
$preco->setNumericMask(2, ',', '.', true);
$dadosPostados = $preco->getPostData();
exitOnEnter
Ativa a ação de saída ao pressionar Enter no campo.
Exemplo de código:
$email = new TEntry('email');
$email->setExitAction(new TAction(['NomeClasseDeControle', 'onExitCampo']));
$email->exitOnEnter();
public static function onExitCampo($param = null)
{
new TMessage('info', print_r($param, true));
}
reloadCompletion
(Método estático) Recarrega as opções de conclusão de um campo de entrada de forma dinâmica.
Parâmetros:
Lista de opções para a conclusão.
(Opcional) Opções adicionais para a conclusão.
$genero = new TEntry('genero');
$genero->setCompletion(['Feminino', 'Masculino']);
$btnGenero = new TButton('btnReloadCompletion');
$btnGenero->addStyleClass('btn-default');
$btnGenero->setImage('far:circle #000000');
$btnGenero->setAction(new TAction([$this, 'alterarOpcoes']), 'Alterar Opções');
public static function alterarOpcoes($param = null)
{
TEntry::reloadCompletion('genero', ['Masculino', 'Feminino', 'Outro', 'Prefiro não dizer']);
}
changeMask
(Método estático) Altera a máscara de um campo de entrada dinamicamente.
Parâmetros:
Nome do campo no formulário.
Nova máscara para o campo.
$cnpj = new TEntry('cnpj');
$cnpj->setValue('1234567800019900000');
$btnCnpj = new TButton('btnCnpjChangeMask');
$btnCnpj->addStyleClass('btn-default');
$btnCnpj->setImage('far:circle #000000');
$btnCnpj->setAction(new TAction([$this, 'alterarMascara']), 'Alterar Máscara');
public static function alterarMascara($param = null)
{
TEntry::changeMask('nomeForm', 'cnpj', '00.000.000/0000-00');
}
