TSortList

__construct

Construtor da classe TSortList. Parâmetros:

mixed

required

Nome do widget.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');

setSize

Define o tamanho da lista. Parâmetros:

mixed

required

Largura da lista.

mixed

default:"NULL"

(Opcional) Altura da lista.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->setSize(300, 150);

addItems

Adiciona itens à lista. Parâmetros:

mixed

required

Array de itens.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);

getItems

Retorna os itens iniciais da lista. Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$itens = $listaOrdenavel->getItems();

setValue

Define os valores da lista. Parâmetros:

mixed

required

Array de valores.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['1' => 'Item 1', '2' => 'Item 2', '3' => 'Item 3']);
$listaOrdenavel->setValue(['3', '2', '1']);

setValueSeparator

Define o separador de valores para a lista. Parâmetros:

mixed

required

Separador de valores.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$listaOrdenavel->setValueSeparator(';');

setOrientation

Define a orientação da lista ordenável. Parâmetros:

mixed

required

Orientação da lista (‘horizontal’ ou ‘vertical’).

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$listaOrdenavel->setOrientation('horizontal');

setLimit

Define um limite para o número de itens na lista. Parâmetros:

mixed

required

Limite de itens.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$listaOrdenavel->setLimit(3);
$listaOrdenavel->addItems(['Item Excedente 1', 'Item Excedente 2']);

setItemIcon

Define o ícone para os itens da lista. Parâmetros:

TImage

required

Ícone para os itens.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Roberto', 'Miranda', 'Júlia', 'Daniel']);
$listaOrdenavel->setItemIcon(new TImage('fas:user-circle'));

connectTo

Conecta esta lista a outra, permitindo interação entre ambas. Parâmetros:

TSortList

required

Outra TSortList.

Exemplo de código:

$listaPessoas = new TSortList('listaPessoas');
$listaPessoas->addItems(['Roberto', 'Miranda', 'Júlia', 'Daniel']);

$listaCargo = new TSortList('listaCargo');
$listaCargo->addItems(['Desenvolvedor Front-End', 'Desenvolvedor Back-End', 'Desenvolvedor Full-Stack']);

$listaPessoas->connectTo($listaCargo);
$listaCargo->connectTo($listaPessoas);

setChangeAction

Define a ação a ser executada quando o usuário altera a lista. Parâmetros:

TAction

required

Objeto TAction que define a ação.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$listaOrdenavel->setChangeAction(['NomeClasseDeControle', 'onItemChange']);

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

public static function onItemChange($param = null)
{
    new TMessage('info', 'O item selecionado foi alterado com sucesso!');
}

setChangeFunction

Define a função JavaScript a ser executada quando o usuário altera a lista. Parâmetros:

mixed

required

Função JavaScript.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);
$listaOrdenavel->setChangeFunction('alert("O item selecionado foi alterado com sucesso!");');

getPostData

Obtém os dados postados pelo formulário. Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$dadosPostados = $listaOrdenavel->getPostData();

reload

(Método estático) Recarrega os itens da lista dinamicamente. Parâmetros:

mixed

required

Nome do formulário.

mixed

required

Nome do campo.

mixed

required

Itens para carregar.

Exemplo de código:

$listaOrdenavel = new TRadioGroup('listaOrdenavel');
$listaOrdenavel->addItems(['Af azer', 'Em andamneto', 'Conclluído']);

$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)
{
    TSortList::reload('nomeForm', 'listaOrdenavel', ['A fazer', 'Em andamento', 'Concluído']);
}

enableField e disableField

(Método estático) Habilita e desabilita um campo da lista no formulário. Parâmetros:

mixed

required

Nome do formulário.

mixed

required

Nome do campo.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);

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

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

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

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

clearField

(Método estático) Limpa um campo da lista no formulário. Parâmetros:

mixed

required

Nome do formulário.

mixed

required

Nome do campo.

Exemplo de código:

$listaOrdenavel = new TSortList('listaOrdenavel');
$listaOrdenavel->addItems(['Item 1', 'Item 2', 'Item 3']);

$btnLimpar = new TButton('btnClearField');
$btnLimpar->addStyleClass('btn-default');
$btnLimpar->setImage('far:circle #000000');
$btnLimpar->setAction(new TAction([$this, 'limparCampo']), 'Remover Itens da Lista');

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)
{
    TSortList::clearField('nomeForm', 'listaOrdenavel');
}

Seleção de dados (fixos)

Seleção de dados (banco de dados)

__construct

setSize

addItems

getItems

setValue

setValueSeparator

setOrientation

setLimit

setItemIcon

connectTo

setChangeAction

setChangeFunction

getPostData

reload

enableField e disableField

clearField

​__construct

​setSize

​addItems

​getItems

​setValue

​setValueSeparator

​setOrientation

​setLimit

​setItemIcon

​connectTo

​setChangeAction

​setChangeFunction

​getPostData

​reload

​enableField e disableField

​clearField

__construct

setSize

addItems

getItems

setValue

setValueSeparator

setOrientation

setLimit

setItemIcon

connectTo

setChangeAction

setChangeFunction

getPostData

reload

enableField e disableField

clearField