BDBTreeView

O BDBTreeView é um componente (derivado da classe BTreeView) especializado em construir uma árvore de visualização baseada em dados provenientes de um banco de dados.

Obs.: todos os métodos presentes nesta documentação utilizarão como base uma tabela chamada “estado”. Esta tabela foi criada em um modelo de dados chamado “docs” e possui quatro colunas: id, nome, sigla e regiao_id, sendo a última uma chave estrangeira para uma tabela chamada “regiao”, esta possuindo as colunas id e nome.

__construct

Construtor da classe BDBTreeView.

Parâmetros:

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})');
$estadosTreeView->setGroups(['{regiao->id}' => '{regiao->nome}']);
$estadosTreeView->enableCheck();

addGroup

Adiciona um grupo à visualização da árvore.

Parâmetros:

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})');
$estadosTreeView->addGroup('norte', 'Região Norte');

setGroups

Define os grupos para a árvore.

Parâmetros:

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$estadosTreeView->setGroups(['brasil' => 'Brasil', 'estados' => 'Estados']);

Obs.: exemplo com grupos baseados em uma coluna de banco de dados presente na seção “__construct()“.

getGroups

Obtém os grupos atuais.

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$grupos = $estadosTreeView->getGroups();

getItemsFromModel

Obtém os itens a partir do modelo definido.

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$itens = $estadosTreeView->getItemsFromModel();

reloadFromModel

(Método estático) Recarrega os itens do modelo para o componente.

Parâmetros:

Exemplo de código:

$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome}');
$estadosTreeView->setGroups(['{regiao->id}' => '{regiao->nome}']);
$estadosTreeView->enableCheck();
        
$btnRecarregar = new TButton('btnReloadFromModel');
$btnRecarregar->addStyleClass('btn-default');
$btnRecarregar->setImage('far:circle #000000');
$btnRecarregar->setAction(new TAction([$this, 'recarregarDados']), 'Recarregar Itens do Modelo');

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

public static function recarregarDados($param = null)
{
    $criterio = new TCriteria();
    $criterio->add(new TFilter('regiao', '=', 'Sudeste'));
    BDBTreeView::reloadFromModel('nomeForm', 'estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})', null, $criterio);
}