TButton

O TButton é um componente que cria botões com ícones e ações associadas (derivado da classe TField). Ele é utilizado para realizar ações quando clicado, podendo conter tanto texto quanto ícones.

__construct

Construtor da classe TButton.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');

setAction

Define a ação do botão.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setAction(new TAction(['NomeClasseDeControle', 'salvar']), 'Salvar');

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

public static function salvar($param = null)
{
    new TMessage('info', 'Salvo com sucesso!');
}

getAction

Retorna a ação do botão.

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setAction(new TAction(['NomeClasseDeControle', 'salvar']), 'Salvar');
$acao = $botaoSalvar->getAction();

setLabel

Define o rótulo do botão.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setLabel('Salvar');

getLabel

Retorna o rótulo do botão.

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setLabel('Salvar');
$rotulo = $botaoSalvar->getLabel(); // Salvar

setImage

Define o ícone do botão.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setLabel('Salvar');
$botaoSalvar->setImage('fas:save #000000');

addStyleClass

Adiciona uma classe CSS ao botão.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setLabel('Salvar');
$botaoSalvar->addStyleClass('btn-primary');

addFunction

Adiciona uma função JavaScript a ser executada pelo botão.

Parâmetros:

Exemplo de código:

$botaoSalvar = new TButton('botaoSalvar');
$botaoSalvar->setLabel('Salvar');
$botaoSalvar->addFunction("alert('Salvo com sucesso!');");

setProperty

Define uma propriedade HTML do componente.

Parâmetros:

Exemplo de código:

$botao = new TButton('botao');
$botao->setLabel('Teste');
$botao->setProperty('class', 'btn-teste');

getProperty

Retorna uma propriedade do componente.

Parâmetros:

Exemplo de código:

$botao = new TButton('botao');
$botao->setLabel('Teste');
$botao->setProperty('categoria', 'interface');
$categoria = $botao->getProperty('categoria'); // interface

enableField e disableField

(Método estático) Habilita e desabilita um campo.

Parâmetros:

Exemplo de código:

$botao = new TButton('botaoEnableDisableField');
$botao->setLabel('Teste');
$botao->addFunction('alert("Salvo com sucesso!");');

$btnHabilitar = new TButton('btnEnableField');
$btnHabilitar->addStyleClass('btn-default');
$btnHabilitar->setImage('far:circle #000000');
$btnHabilitar->setAction(new TAction([$this, 'habilitarCampo']), 'Habilitar Botão "Teste"');

$btnDesabilitar = new TButton('btnDisableField');
$btnDesabilitar->addStyleClass('btn-default');
$btnDesabilitar->setImage('far:circle #000000');
$btnDesabilitar->setAction(new TAction([$this, 'desabilitarCampo']), 'Desabilitar Botão "Teste"');

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)
{
    TButton::enableField('nomeForm', 'botaoEnableDisableField');
}

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