Skip to main content

​
__construct

Construtor da classe TEntry. Parâmetros:
​
$name
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:
​
$value
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:
​
$mask
mixed
required
Máscara para os dados de entrada.
​
$replaceOnPost
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:
​
$decimals
mixed
required
Número de casas decimais.
​
$decimalsSeparator
mixed
required
Separador para o ponto decimal.
​
$thousandSeparator
mixed
required
Separador de milhares.
​
$replaceOnPost
bool
default:"false"
(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.
​
$reverse
bool
default:"false"
(Opcional) Booleano indicando se a máscara deve ser invertida.
​
$allowNegative
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:
​
$options
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:
​
$length
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:
​
$length
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:
​
$action
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:
​
$function
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:
​
$toggleVisibility
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:
​
$delimiter
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:
​
$image
TImage
required
Objeto TImage representando o ícone.
​
$side
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:
​
$field
mixed
required
Nome ou ID do campo.
​
$list
mixed
required
Lista de opções para a conclusão.
​
$options
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:
​
$formName
mixed
required
Nome do formulário.
​
$name
mixed
required
Nome do campo no formulário.
​
$mask
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');
}