TEntry - Mad.Builder

__construct

Construtor da classe TEntry. Parâmetros:

mixed

required

Nome do campo que será utilizado no formulário.

Exemplo de código:

$cnpj = new TEntry('cnpj');

setValue

Define o valor do campo. Parâmetros:

mixed

required

Uma string contendo o valor do campo.

Exemplo de código:

$cnpj = new TEntry('cnpj');
$cnpj->setValue('00.000.000/0000-00');

setMask

Define a máscara do campo. Parâmetros:

mixed

required

Máscara para os dados de entrada.

bool

default:"false"

(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.

Exemplo de código:

$cpf = new TEntry('cpf');
$cpf->setMask('000.000.000-00');

setNumericMask

Define a máscara numérica do campo. Parâmetros:

mixed

required

Número de casas decimais.

mixed

required

Separador para o ponto decimal.

mixed

required

Separador de milhares.

bool

default:"false"

(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.

bool

default:"false"

(Opcional) Booleano indicando se a máscara deve ser invertida.

bool

default:"true"

(Opcional) Booleano indicando se valores negativos são permitidos.

Exemplo de código:

$preco = new TEntry('preco');
$preco->setNumericMask(2, ',', '.');    

Exemplo de código (com parâmetros opcionais):

$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

required

Array de opções para conclusão.

Exemplo de código:

$genero = new TEntry('genero');
$genero->setCompletion(['Feminino', 'Masculino', 'Outro', 'Prefiro não dizer']);    

setMaxLength

Define o comprimento máximo do campo. Parâmetros:

mixed

required

Comprimento máximo do campo.

Exemplo de código:

$rg = new TEntry('rg');
$rg->setMaxLength(10);

setMinLength

Define o comprimento mínimo para pesquisa (requer uso do ‘setCompletion’). Parâmetros:

mixed

required

Comprimento mínimo para pesquisa.

Exemplo de código:

$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:

TAction

required

Objeto TAction.

Exemplo de código:

$cep = new TEntry('cep');
$cep->setExitAction(new TAction(['NomeClasseDeControle', 'onExitCampo']))

Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).

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:

mixed

required

Função JavaScript.

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:

bool

default:"true"

(Opcional) Booleano indicando se a opção deve ser ativada.

Exemplo de código:

$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:

mixed

required

Delimitador de conclusão automática.

Exemplo de código:

$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:

TImage

required

Objeto TImage representando o ícone.

string

default:"right"

(Opcional) Lado do ícone.

Exemplo de código:

$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();

Exemplo de código (com máscara numérica):

$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();

Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).

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:

mixed

required

Nome ou ID do campo.

mixed

required

Lista de opções para a conclusão.

mixed

default:"null"

(Opcional) Opções adicionais para a conclusão.

Exemplo de código:

$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');

Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).

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:

mixed

required

Nome do formulário.

mixed

required

Nome do campo no formulário.

mixed

required

Nova máscara para o campo.

Exemplo de código:

$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');

Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).

public static function alterarMascara($param = null)
{
    TEntry::changeMask('nomeForm', 'cnpj', '00.000.000/0000-00');
}