Skip to main content

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.

Derivado da classe TEntry, métodos herdados não sobrescritos podem também ser utililzados por objetos TTime. Acesse a documentação do componente/classe-pai para conhecê-los.

​
__construct

Construtor da classe TTime. Parâmetros:
​
$name
mixed
required
Nome do campo que será utilizado no formulário.
 Exemplo de código: 
$horario = new TTime('horario');

​
setMask

Define a máscara do campo de tempo. 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: 
$horario = new TTime('horario');
$horario->setMask('hh:ii:ss');

​
setChangeAction

Define a ação a ser executada quando o usuário altera o campo de tempo. Parâmetros:
​
$action
TAction
required
Objeto TAction.
 Exemplo de código: 
$horario = new TTime('horario');
$horario->setChangeAction(new TAction(['NomeClasseDeControle', 'onTimeChange']));
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function). 
public static function onTimeChange($param = null)
{
    new TMessage('info', 'A hora foi alterada com sucesso!');
}

​
setChangeFunction

Define a função JavaScript a ser executada quando o usuário altera o campo de tempo. Parâmetros:
​
$function
mixed
required
Função JavaScript.
 Exemplo de código: 
$horario = new TTime('horario');
$horario->setChangeFunction('alert("Hora alterada.");');

​
enableField e disableField

(Método estático) Habilita ou desabilita um campo de hora no formulário. Parâmetros:
​
$form_name
mixed
required
Nome do formulário.
​
$field
mixed
required
Nome do campo.
 Exemplo de código: 
$horario = new TTime('hora');
$horario->setValue('10:00');

$btnHabilitar = new TButton('btnEnableField');
$btnHabilitar->addStyleClass('btn-default');
$btnHabilitar->setImage('far:circle #000000');
$btnHabilitar->setAction(new TAction([$this, 'habilitarCampo']), 'Habilitar Campo de Tempo');

$btnDesabilitar = new TButton('btnDisableField');
$btnDesabilitar->addStyleClass('btn-default');
$btnDesabilitar->setImage('far:circle #000000');
$btnDesabilitar->setAction(new TAction([$this, 'desabilitarCampo']), 'Desabilitar Campo de Tempo');
Código de exemplo das funções a serem chamadas, lembrando que essas funções precisam ser estáticas (static function). 
public static function habilitarCampo($param = null)
{
    TTime::enableField('nomeForm', 'hora');
}

public static function desabilitarCampo($param = null)
{
    TTime::disableField('nomeForm', 'hora');
}