TRadioGroup

O TRadioGroup é um componente que agrupa múltiplos RadioButtons (derivado da classe TField), permitindo ao usuário selecionar uma das várias opções fornecidas.

__construct

Construtor da classe TRadioGroup.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');

__clone

Clona o objeto TRadioGroup, replicando os botões e rótulos atuais.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$generoClone = clone $genero;

setBooleanMode

Ativa o modo booleano, onde o grupo oferece apenas as opções “Sim” e “Não”.

Exemplo de código:

$confirmacao = new TRadioGroup('confirmacao');
$confirmacao->setBooleanMode();

addItems

Adiciona itens ao grupo.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);

getItems

Retorna os itens do grupo.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$itens = $genero->getItems();

setValue

Define o valor do campo.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setValue('O');

getValue

Retorna o valor do campo.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setValue('F');
$valor = $genero->getValue();

setLayout

Define a direção dos itens do grupo.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setLayout('horizontal');

getLayout

Retorna a disposição atual dos botões no grupo (vertical ou horizontal).

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->setLayout('vertical');
$layout = $genero->getLayout();

setBreakItems

Define após quantos itens o grupo deve quebrar a linha.

Parâmetros:

Exemplo de código:

$frequencia = new TRadioGroup('frequencia');
$frequencia->addItems(['1' => 'Diariamente', '2' => 'Semanalmente', '3' => 'Mensalmente', '4' => 'Semestralmente', '5' => 'Anualmente', '6' => 'Raramente', '7' => 'Nunca']);
$frequencia->setLayout('horizontal');
$frequencia->setBreakItems(2);

setUseButton

Configura o grupo para exibir as opções como botões.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setUseButton();

getButtons

Retorna os botões de opção do grupo.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setUseButton();
$botoes = $genero->getButtons();

getLabels

Retorna os rótulos dos botões de opção.

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$rotulos = $genero->getLabels();

setChangeAction

Define a ação a ser executada quando o usuário altera a seleção.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setChangeAction(new TAction(['NomeClasseDeControle', 'onStatusChange']));

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

public static function onStatusChange($param = null)
{
    new TMessage('info', 'O status do botão foi alterado com sucesso!');
}

setChangeFunction

Define uma função JavaScript a ser executada quando o usuário muda a seleção.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);
$genero->setChangeFunction('alert("O status do botão foi alterado com sucesso!");');

getPostData

Obtém os dados enviados pelo formulário após serem processados pelo controle.

Exemplo de código:

$confirmacao = new TRadioGroup('confirmacao');
$confirmacao->setBooleanMode();
$dadosPostados = $confirmacao->getPostData();

reload

(Método estático) Recarrega os itens do grupo de rádio dinamicamente.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Msaculino', 'F' => 'Feminno', 'O' => 'Ouyro']);

$btnRecarregar = new TButton('btnReload');
$btnRecarregar->addStyleClass('btn-default');
$btnRecarregar->setImage('far:circle #000000');
$btnRecarregar->setAction(new TAction([$this, 'recarregarCampo']), 'Recarregar Opções');

Código de exemplo das funções a serem chamadas, lembrando que essas funções precisam ser estáticas (static function).

public static function recarregarCampo($param = null)
{
    TRadioGroup::reload('nomeForm', 'genero', ['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro'], true);
}

enableField e disableField

(Método estático) Habilita ou desabilita um campo no formulário.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);

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

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

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

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

clearField

(Método estático) Limpa o valor de um campo no formulário.

Parâmetros:

Exemplo de código:

$genero = new TRadioGroup('genero');
$genero->addItems(['M' => 'Masculino', 'F' => 'Feminino', 'O' => 'Outro']);

$btnLimpar = new TButton('btnClearField');
$btnLimpar->addStyleClass('btn-default');
$btnLimpar->setImage('far:circle #000000');
$btnLimpar->setAction(new TAction([$this, 'limparCampo']), 'Limpar Seleção');

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

public static function limparCampo($param = null)
{
    TRadioGroup::clearField('nomeForm', 'genero');
}