Adianti Framework 3 - Leanpubsamples.leanpub.com/adiantiframeworknapratica-sample.pdfOqueéAdiantiFramework O Adianti framework é um framework desenvolvido pela Adianti Solutions

Adianti Framework 3.0Na Pratica

Alexandre E. Souza

Esse livro está à venda em http://leanpub.com/adiantiframeworknapratica

Essa versão foi publicada em 2016-05-19

This is a Leanpub book. Leanpub empowers authors and publishers with the Lean Publishingprocess. Lean Publishing is the act of publishing an in-progress ebook using lightweight tools andmany iterations to get reader feedback, pivot until you have the right book and build traction onceyou do.

© 2014 - 2016 Alexandre E. Souza

http://leanpub.com/adiantiframeworknapratica

http://leanpub.com

http://leanpub.com/manifesto

Conteúdo

Quem Sou eu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

O que é Adianti Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Instalação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5TTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5TPanel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6TNoteBook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7TScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8TFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8TVBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9THBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11TWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Dialogs TMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13TQuestion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14InputDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16TQuickForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16TEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20TPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

TDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TSpinner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TSlider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TCheckGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

CONTEÚDO

TRadioGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23THtmlEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23TLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25TQuickGrid Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29TDataGrid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Grid com Componentes de formulário . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Condições para Opções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Quem Sou euMeu Nome é Alexandre Evangelista de Souza, sou desenvolvedor php e um amante de tecnologiasprocuro sempre apreender novas tecnologias e aplicalas na linguagem que mais uso, o php.

1

IntroduçãoApos o lançamento da nossa primeira versão do ebook adianti na pratica 2.0, tivemos um otimofeedback dos leitores e amigos da comunidade, sendo assim nessa edição irei, preencher algumasdas lacunas que foram mostradas da versão anterior.

todos os exmplos usados estam em

<<Git Com o Codigo¹

** Hora do show **

¹https://github.com/ale-php/livro_adianti_3_0

2

https://github.com/ale-php/livro_adianti_3_0

https://github.com/ale-php/livro_adianti_3_0

O que é Adianti FrameworkO Adianti framework é um framework desenvolvido pela Adianti Solutions com o foco dedesenvolver sistemas ele usa uma arquitetura paseada em componentes , tem uma estrutura bemestruturada e segura , do qual permite aos usuarios criarem componetes como serviços, mesmoo seu foco sendo desenvolvimento de sistema é perfeitamente possivel desenvolver sites com ele,usando o framework para o painel admin e criando uma API Rest para ser consumida pelo angular,esse assunto sera abordado em um dos nossos futuros ebooks.

O Adianti framework conta com uma comunidade ativa tanto no seu forum quando no facebook acomunidade esta crescendo e o framework sempre sofre alterações, para melhorias, e concerto debugs

3

InstalaçãoA instalação do Adianti framework é bem simples de ser realizada, basta entrar no site Adiantiframework² , após isso basta clicar na opção baixar adianti framework, a segunda opção é para odesenvolvimento em desktop, que sera abordada em outra edição da serie de Programador paraProgramador. Feito isso ira baixar o framework compactado, basta descompactar e colocar na pastaraiz do seu apache.

²http://www.adianti.com.br/framework-download

4

http://www.adianti.com.br/framework-download



ComponentesVamos conhecer alguns dos componentes do framework, nosso foco é conhecer a versão 2.0 , assimpara aqueles que nunca usaram , não se preocupem iremos abordar todos os componentes comexemplos, detalhados. Containers Os Containers são componentes onde podemos inserir outroscomponentes , para alinha-los de melhor maneira, vamos ver um exemplo de cada um deles.

TTable

Nosso primeiro container sera a TTable, que é a tabela do HTML esse container organiza osobjetos em tabelas, onde o método addRowSet, permite adicionar vários objetos em uma mesmalinha da tabela, no nosso exemplo temos 2 campos nome e sobrenome, não se preocupem com oscomponentes TEntry, iremos velos futuramente. Essa tabela é padrão, mas podemos otimiza lá , paraque possa atender nossa necessidade, essa estrutura usada é a padrão do framework todas as paginasdevem estender alguma class como TPage, TWindow, TStandardList etc.., veremos todas em nossosexemplos.

TTableView

1 <?php

2

3 class TTableView extends TPage

4 {

5 function __construct(){

6 parent::__construct();

7 $table = new TTable(); //componente TTable

8

9 $nome = new TEntry('nome');

10 $sobrenome = new TEntry('sobrenome');

11 $table->addRowSet(new TLabel('nome'),$nome); // linha com 2 componentes

12 $table->addRowSet(new TLabel('sobrenome'),$sobrenome);

13 parent::add($table);

14 }

15 }

16 ?>

Vamos ver essa tabela otimizada, podemos mudar o espaço entre as celulas, e as propriedades css

5

Componentes 6

ViewTPanel

1 <?php

2

3 class TTableView extends TPage

4 {



7 $table = new TTable(); //componente TTable

8



11 $table->addRowSet(new TLabel('nome'),$nome); // linha com 2 componentes


13 parent::add($table);

14 }

15 }

16 ?>

TPanel

Como podem ver o uso da TTable é bem simples , podemos usa-la para alinhar componentes emformulários como veremos mais adianti, seguindo nossa linha de raciocínio temos o TPanel, essepainel é interessante pois permite alinharmos os componentes dentro dele manualmente.

ViewTPanel

1 <?php

2 class ViewTPanel extends TPage

3 {



6 $panel = new TPanel(500,500);

7 $panel->style ="border: 1px solid #000;";


9 //$nome->setSize(200); caso queira facilitar os calculos coloque uma largura\

10 n\

11 os componentes

12 $lnome = new TLabel('nome');

13 //$lnome->setSize(50);

14 $panel->put($lnome,0,50);//componente,coluna, linha

15 $panel->put($nome,40,40);

Componentes 7

16 parent::add($panel);

17 }

18 }

19 ?>

o TPanel é mais flexível em aspecto de posição , podemos editar a opção style, como a tabela, atemesmo colocar uma class usando $panel->class dessa forma podemos ter painéis, estilizados.

TNoteBook

Esse componente é um dos mais interessantes, ele permite organizar os componenstes em abas, epode ser combinado com o TPanel ou a Table ou com ambos.

A Grande novidade da versão 3.0 é poder adcionar o estilo bootstrap 3 em alguns componentes taiscomo o TNotebook

ViewTNoteBook

1 <?php

2 class ViewTNoteBook extends TPage

3 {




7 $panel->style ="border: 1px solid #000;";


9 //$nome->setSize(200); caso queira facilitar os calculos coloque uma largura\

10 n\

11 os componentes

12 $lnome = new TLabel('nome');

13 //$lnome->setSize(50);

14 $panel->put($lnome,0,50);//componente,coluna, linha

15 $panel->put($nome,40,40);

16 $table = new TTable();

17 $table->style = "border:1px solid #000";

18 $nome2 = new TEntry('nome2');


20 $table->addRowSet(new TLabel('nome2'),$nome2);


22

23 //adciona o estilo bootstrap no notebook

24 $notebook = new BootstrapNotebookWrapper(new TNotebook(600,320));//largura e\

Componentes 8

25 altura

26 $notebook->appendPage('Tabela',$table);

27 $notebook->appendPage('Panel',$panel);

28 parent::add($notebook);

29 }

30

31 ?>

TScroll

Este componente cria uma barra de rolagem dentro de um container, caso tenha uma quantidade decomponente alem do tamanho do container em questão, vamos ao modo de uso, usaremos em umTNotebook.

ViewTScroll

1 <?php

2 class ViewTScroll extends TPage

3 {



6 $scroll = new TScroll(); // cria o scroll

7 $scroll->setSize(450,300); // largura e altura


9 $notebook = new TNotebook(500,400);//largura e altura

10 $scroll->add($panel);

11 $notebook->appendPage('Panel',$scroll);


13 }

14 }

15 ?>

Como podem ver temos um panel dentro do TScroll, se o componente que estiver dentro do TScrolltiver uma altura ou largura maiores, que do TScroll ele ira criar as barras de rolagem para que ousuário possa utilizar, esse componente é útil quando se ter formulários grandes.

TFrame

Este componente tem um uso interessante, segundo exemplos do próprio tudor alguns componentes, podem ter interação direto via jquery, para mostrar ou esconder componentes, usuário o Notebookpara mostrar o uso desse componente , lembrando que pode ser combinado com outro container.

Componentes 9

ViewTFrame

1 <?php

2 class ViewTFrame extends TPage

3 {



6 $cpf = new TEntry('cpf');

7 $rg = new TEntry('rg');

8 $fields = new TTable();

9 $fields->addRowSet(new TLabel('CPF:'),$cpf);

10 $fields->addRowSet(new TLabel('RG:'),$rg);

11 $frame = new TFrame;

12 $frame->oid = 'frame';

13 $frame->setLegend('Dados Opcionais');

14 $frame->add($fields);

15 $button = new TButton('show_hide');

16 $button->class = 'btn btn-success btn-sm active'; // class do bootstrap 3

17 $button->setLabel('Dados Opcionais');

18 //codigo usando jquery, podemos usar outros codigos alem desse.

19 $button->addFunction("\$('[oid=frame]').slideToggle(); $(this).toggleCla\

20 ss( 'active' )");

21 $page = new TTable();

22 $page->addRowSet($button);

23 $page->addRowSet($frame);


25 $notebook->appendPage('Panel',$page);


27 }

28 }

29 ?>

Nesse código temos uma demostração de como alterar a class de um TButton para usar class dobootstrap 3 onde também inserimos uma action usando jquery que muda o estado do TButton emostra e esconde o TFrame, esse efeito pode ser usado em outros componentes desde que, saiba oid do componente.

TVBox

Este componete serve para podermos organizar outros componentes em Vertical , caso não queirausar TTable para fazer isso, vejamos 2 formas de usalo.

Componentes 10

ViewTVBox

1 <?php

2 class ViewTVBox extends TPage

3 {




7 $cpf->setTip('CPF'); // titulo para quando passar o mause sobre o campo


9 $rg->setTip('RG');

10 $vbox = new TVBox();

11 $vbox->add($cpf);

12 $vbox->add($rg);


14 $notebook->appendPage('Panel',$vbox);


16 }

17 }

18 ?>

nesse exemplo usando o setTip do TEntry, para mostrar uma legenda quando passar o mouse sobreo campo, e adcionamos um a um no TVBox, veremos um metodo mais rapido e com poucas linhas.

ViewTVBoxFast

1 <?php

2 class ViewTVBoxFast extends TPage

3 {




7 $cpf->setTip('CPF');



10 $vbox = new TVBox();

11 $vbox->addColSet($cpf,$rg);

12 $notebook = new BootstrapNotebookWrapper(new TNotebook(300,200));//largura e\

13 altura

14 $notebook->appendPage('Panel',$vbox);


16 }

Componentes 11

17 }

18 ?>

Dessa forma passamos os campos em uma unica linha e ele adciona cada campo em uma linhadiferente, é uma otima forma de organizar containers dentro de um form ou dentro de umTNoteBook.

THBox

Esse Container alinha os componentes na Horizontal funciona da mesma forma que o TVBox poremna horizontal, vamos ver o exemplo de uso.

ViewTHBoxFast

1 <?php

2 class ViewTHBoxFast extends TPage

3 {







10 $hbox = new THBox();

11 $hbox->addRowSet($cpf,$rg);


13 $notebook->appendPage('Panel',$hbox);


15 }

16 }

17 ?>

TWindow

Esse Container é bem interessante, ele permite que mostre a pagina em modal, podendo ou nãoblokiar outras ações, vamos a pratica.

Componentes 12

ViewTWindow

1 <?php

2 class ViewTWindow extends TWindow

3 {



6 parent::setTitle('Titulo da janela'); // titulo da janela

7 parent::setSize(500,400); //tamanho da janela

8 parent::setModal(true); // coloca em modo modal bloqueando as





13 $hbox = new THBox();

14 $hbox->addRowSet($cpf,$rg);


16 $notebook->appendPage('Panel',$hbox);


18 }

19 }

20 ?>

Dialogs TMessageEssas caixas de Dialogo nos permite, mostrar informações ,alertas até mesmo opções, ao usuário demaneira simples. vamos ao nosso primeiro exemplo.

Info

ViewTMessage

1 <?php

2 class ViewTMessage extends TPage

3 {



6 new TMessage('info','Seja bem vindo',null,'Bem Vindo');

7 }

8 }

9 ?>

Neste exemplo temos a TMessagem para informação, é interessante nota que temos uma parâmetronull , nesse componente , que é um tipo TAction, onde a ação é executada se a janela é fechada.Vamos ao exemplo de janela de erro

Error

ViewTMessageError

1 <?php

2 class ViewTMessageError extends TPage

3 {



6 new TMessage('error','Não pode fazer esta ação',null,'Erro');

7 }

8 }

9 ?>

Como podem ver nesse exemplo mudamos apenas de info para error, bem simples não vamos aoexemplos um pouco mais complexos.

13

Dialogs TMessage 14

TQuestion

Esse componente permite que o usuário tenha escolha , como se aceita ou não apagar um contadomuito útil para confirmação, antes de apagar qualquer informação.

ViewTQuestion

1 <?php

2 class ViewTQuestion extends TPage

3 {



6

7 $action1 = new TAction(array($this,'onComfirme'));

8 $action2 = new TAction(array($this,'onCancel'));

9 new TQuestion('Deseja deletar esse contato ?',$action1,$action2,'Deletar \

10 COntato');

11 }

12 public function onComfirme(){

13 new TMessage('info','Confimado',null,'Confirmado');

14 }

15 public function onCancel(){

16 new TMessage('error','Deletar',null,'Deletar');

17 }

18 }

19 ?>

Como podem notar temos , opções diferentes para cada escolha do usuário, sendo assim maiorcontrole da aplicação, e evitamos que apague uma informação , sem ter certeza do que se estafazendo. Vamos agora a mais uma novidade dessa verção,

InputDialog

Nesse exemplo veremos como se faz um form de login usando esse componente.

Dialogs TMessage 15

ViewTInputDialog

1 <?php

2 class ViewTInputDialog extends TPage

3 {



6 $form = new TQuickForm('InputDialog');

7 $action = new TAction(array($this,'onMostrar'));

8 $form->addQuickAction('btnMostrar',$action,'bs:floppy-disk red');

9 parent::add($form);

10 }

11 public function onMostrar(){

12 $form = new TQuickForm('input_form');

13 $form->style = 'padding:20px';

14 $login = new TEntry('login');

15 $pass = new TPassword('password');

16 $form->addQuickField('Login', $login);

17 $form->addQuickField('Password', $pass);

18 $form->addQuickAction('Confirm 1', new TAction(array($this, 'onComfirme')), \

19 'ico_save.png');

20 $form->addQuickAction('Confirm 2', new TAction(array($this, 'onCancel'))

21 , 'ico_apply.png');

22 // show the input dialog

23 new TInputDialog('Input dialog title', $form);

24 }


26 new TMessage('info','Confimado',null,'Confirmado');

27 }



30 }

31 }

32 ?>

Não se preocupem com os forms e outros componentes nosso foco é o método onMostrar comopodem ver, quando chamamos o método através de um formulário rápido a caixa é mostrada como nosso outro formulário contendo 2 action, ou seja é o mesmo conceito da TQuestion porem maiscompleto.

FormsNesse capitulo iremos ver TUDO sobre formulário, como criar, como estilizar, e veremos TODOSseus componentes. Primeiramente vamos conhecer o TQuickForm, que é a criação de formuláriosrápidos.

TQuickForm

ViewTQuickForm

1 <?php

2 class ViewTQuickForm extends TPage

3 {



6 $form = new BootstrapFormWrapper(new TQuickForm('input_form')); // cria o fo\

7 rmulario

8 $login = new TEntry('login'); // cria input do tipo text

9 $pass = new TPassword('password'); //cria input do tipo password

10 $form->addQuickField('Login', $login); // adciona campo com label no form

11 $form->addQuickField('Password', $pass);

12 // adciona botoes de ação, já com ação onde

13 //addQuickAction(label,action,icone);

14 $form->addQuickAction('Confirm 1', new TAction(array($this, 'onComfirme')), \

15 'bs:plus green');

16 $form->addQuickAction('Confirm 2', new TAction(array($this, 'onCancel')) , \

17 'fa:trash-o blue');

18

19 parent::add($form);

20

21 }


23 new TMessage('info','COnfimado',null,'Confirmado');

24 }



27 }

28 }

29 ?>

16

Forms 17

Nesse código temos uma explicação sobre o TEntry e o TPassword como podem ver são simplescampos html, outro ponto importante são os ícones usados nas QuickAction, temos no Comfirm1um ícone do bootstrap 3 onde usa-se bs:nomeico cor, dessa maneira posso usar todos os íconesdo bootstrap 3, já no comfirm 2 temos o conde da Font awesome onde podemos usar todos seusícones usando fa:icone cor, dessa maneira podemos usar nos botões também , para assim termos ummelhor visual de nosso sistema, como sabemos não adianta ser funcional se não for bonito. Vamosaproveitar o contexto e ver todos os componentes que podem ser usados nos formulários e comopegar o conteúdo de cada um deles.

FormCustomView

1 <?php

2 class FormCustomView extends TPage

3 {

4 private $form;

5 /**

6 * Class constructor

7 * Creates the page

8 */

9 function __construct()

10

11 {


13 // create the notebook

14 $notebook = new TNotebook(620, 340);

15 // create the form

16 $this->form = new TForm;

17 // creates the notebook page

18 $table = new TTable;

19 $table2 = new TTable;

20 $table3 = new TTable;

21 // add the notebook inside the form

22 // create the form fields

23 $field1 = new TEntry('field1');




27 $field5 = new TPassword('field5');

28 $field6 = new TDate('field6');

29 $field7 = new TSpinner('field7');

30 $field8 = new TSlider('field8');

31 $field9 = new TText('field9');

32 $field10 = new TImage('app/images/42_thumb.jpeg');

Forms 18

33 $field10->width = '100px';

34 $field11 = new TCombo('field13'); // combo box

35 // imagem

36 // itens do fiend11

37 $itens = array('alexandre'=>"alexandre",'Elbert'=>"Elbert");

38 $field11->addItems($itens); // adciona os itens

39 $field12 = new TCheckGroup('checkbox');

40 $field13 = new TRadioGroup('radiobutton');

41 // grupo de checkbox

42 $field12->addItems(array('php'=>'php','asp'=>'asp','javascript'=>'javascript\

43 '));

44 // adciona itens no radio grupo

45 $field13->addItems(array('masculino'=>'masculino','feminino'=>'feminino'));

46

47 $field14 = new THtmlEditor('field10');

48 $field14->setSize(400,200);

49

50 $field1->setTip('Tip para field 1'); // usando tipo

51

52 $field2->setValue('123');

53 $field2->setEditable(FALSE);

54 $field3->setMask('99.999-999');

55 $field4->setMaxLength(10);

56 $field6->setSize(100);

57 $field7->setRange(0,100,10);

58 $field8->setRange(0,100,10);

59 $field7->setValue(30);

60 $field8->setValue(50);

61 $field9->setSize(300, 50);

62

63 // add rows for the fields

64 $table->addRowSet( new TLabel('TEntry object:'), $field1 );

65 $table->addRowSet( new TLabel('TEntry not editable:'), $field2 );

66 $table->addRowSet( new TLabel('TEntry with mask:'), $field3, new TLabel('99.\

67 999-999') );

68 $table->addRowSet(






74 $table2->addRowSet(

Forms 19




78

79 new TLabel('TEntry with maxlength (10):'), $field4 );

80 new TLabel('TPassword object:'), $field5 );

81 new TLabel('TDate Object:'), $field6 );

82 new TLabel('Spinner Object:'), $field7 );

83 new TLabel('Slider Object:'), $field8 );

84 new TLabel('TText Object:'), $field9 );

85 new TLabel('IMagem:'), $field10 );

86 new TLabel('ComboBox'), $field11 );

87 new TLabel('Checkbox'), $field12 );

88 new TLabel('RadioButtons'), $field13 );

89 $table3->addRowSet( new TLabel('Editor HTML'), $field14 );

90 // creates the action button

91 $button1=new TButton('action1');

92 // define the button action

93 $button1->setAction(new TAction(array($this, 'mostrarDados')), 'mostrarD\

94 ados');

95 $button1->setImage('bs:search');

96 // define wich are the form fields

97 $this->form->setFields(array($field1, $field2, $field3, $field4, $field5,

98 $field6, $field7, $field8, $field9,$field1\

99 1,$field12,$field13,$field14, $button1));

100 // add a row for the button

101 $row=$table->addRow();

102 $row->addCell($button1);

103 // adds the notebook page

104 $notebook->appendPage('Input elements', $table);

105 $notebook->appendPage('Input elements 2', $table2);

106 $this->form->add($notebook);

107 parent::add($this->form);

108 }

109

110

111 public function mostrarDados($param)

112 {

113 $data = $this->form->getData(); // optional parameter: active record cla\

114

115 // put the data back to the form

116 $this->form->setData($data);

Forms 20

117

118

119 // creates

120

121 $message = "a string with the form element's values";

122 $message .= 'TEntry : ' . $data->field1 . ' ';

123 $message .= 'TEntry not editable : ' . $data->field2 . ' ';

124 $message .= 'TEntry with mask: ' . $data->field3 . ' ';

125 $message .= 'TEntry with maxlength (10) : ' . $data->field4 . ' ';

126 $message .= 'TPassword object : ' . $data->field5 . ' ';

127 $message .= 'TDate Object: ' . $data->field6 . ' ';

128 $message .= 'Spinner Object : ' . $data->field7 . ' ';

129 $message .= 'Slider Object: ' . $data->field8 . ' ';

130 $message .= 'TText Object : ' . $data->field9 . ' ';

131 $message .= 'Editor HTML : ' . $data->field10. ' ';

132

133 // grupos de campos

134 echo "TCheckGoup";

135 print_r($data->checkbox) ;

136 echo "TRadioGroup";

137 print_r($data->radiobutton);

138 // show the message

139 new TMessage('info', $message);

140 }

141 }

142 ?>

TEntry

esse componente cria um iput do tipo texto onde podem ser alterados seu Tip, e inserido mascarasseu uso é bem simples

TEntry

1 <?php

2


4 $field1->setTip('Tip for field 1'); // dica de campo

5 $field1->setValue('123'); // seta valor inicial

6 $field1->setEditable(FALSE); // bloqueia edição de valor

7 $field1->setMask('99.999-999'); // mascara para valores

8 $field1->setMaxLength(10); // limit de caracters

Forms 21

9 $field1->{css} = "background-color:#efffef";

10

11 ?>

como podem ver temos uma vasta lista de propriedades que podemos usar e o interessante quepodemos alterar class do css e até mesmo o css

TPassword

1 <?php

2

3 $field1 = new TPassword('field1');

4

5 ?>

é um campo simples onde tem as opções do TEntry porem é um campo para senhas

TDateé um campo usado para, datas por padrão sua mascara é no formato Y-m-d mas pode ser alteradousando o setmask.

1 $field1 = new TDate('field1');

2 $field1->setMask('dd/mm/Y');

TSpinner

Esse componente permite que o usuário , use apenas números, particularmente esse setRange, nãofunciona como deveria, mas pode vim a ser útil.

1 $field1 = new TSpinner('field1');

2 $field1->setRange($min,$max,$step) // para trocar os valores

TSlider

Esse componente permite que o usuário , use uma barra para escolher o valor , em numero bom paragerenciadores de tarefas ou processos.

1 $field1 = new TSlider('field1');

2 $field1->setRange($min,$max,$step) // para trocar os valores

TText

Componente usado para caixa de texto onde se pode passar uma altura e largura é um campo simples,onde o usuário não pode usar qualquer formatação para o texto.

1 $field1 = new TText('field1');

2 $field1->setSize($width, $height); // largura , altura

TImage

22

TDate 23

1 <?php

2

3 $field1 = new TImage('app/images/42_thumb.jpeg');

4 $field1->width = '100px'; // pode usar as propriedades da imagem para altera-la

5

6 ?>

TCheckGroup

Este campo é usado para criar grupos de checkbox, onde se passa uma array , na propriedade setItensonde o usuario pode selecionar varios itens, ao mesmo tempo

1 <?php

2

3 $field1 = new TCheckGroup('cursos');

4 // array de itens, para utilizar na hora de pegar os valores.

5 $field1->addItems(array('php'=>'php','asp'=>'asp','javascript'=>'javascript'));

6

7 ?>

TRadioGroup

Utilizado quando é restrito a escolha de um único item , como por exemplo em um formulário ondese tem que escolher seu sexo.

1 <?php

2 $field1 = new TRadioGroup('sexo');

3 // array de itens, para utilizar na hora de pegar os valores.

4 $field1->addItems(array('php'=>'php','asp'=>'asp','javascript'=>'javascript'));

5

6 ?>

THtmlEditor

Cria uma caixa de edição de texto, semelhante ao editor de texto simples com recursos de edição, veremos futuramente, uma class semelhante na PWD, onde temos um componente, semelhante ,porem melhorado.

TDate 24

1 <?php

2

3 $field1 = new THtmlEditor('field1');

4 $field1->setSize(400,200);

5

6 ?>

TLabel

Esse componente cria uma label para os campos, é usado para indicar um campo.

1 <?php

2

3 $lfield1 = new TLabel('CPF');

4 $lfield1->class = 'label label-success';

5

6 ?>

nas Grids e ver como elas funcionam, a algum tempo , listar dados em tabelas era um terror linhas, colunas porem com o Adianti fica tudo mais lindo, e facíl

GridsO Objetivo das grids é justamente mostrar o quanto é facil, mostrar conteúdo e as personalizar. Paranosso primeiro exemplo vamos usar o exemplo do tutor

DatagridQuickView

1 <?php

2 /**

3 * DatagridQuickView

4

5 */

6 class DatagridQuickView extends TPage

7 {

8 private $datagrid;

9 public function __construct()

10 {


12 // creates one datagrid

13 $this->datagrid = new TQuickGrid;

14 $this->datagrid->setHeight(320);

15 // add the columns

16 $this->datagrid->addQuickColumn('Code',

17 'code',

18 'right', 70, new TAction(array($this, 'onColumnAction')), array('column', 'c\

19 ode'));

20 $this->datagrid->addQuickColumn('Name',

21 'name',

22 'left', 180, new TAction(array($this, 'onColumnAction')), array('column', 'n\

23 ame'));

24 $this->datagrid->addQuickColumn('Address', 'address', 'left', 180, new TActi\

25 on(array($this, 'onColumnAction')), array('column', 'address'));

26

27 $this->datagrid->addQuickColumn('Phone','fone','left', 160, new TAction(arra\

28 y($this, 'onColumnAction')), array('column', 'fone'));

29 $this->datagrid->enablePopover('Popover', 'Hi {name} ');

30 // add the actions

31 $this->datagrid->addQuickAction('View',

32 new TDataGridAction(array($this, 'onView')),'name', 'ico_find.png');

33 $this->datagrid->addQuickAction('Delete', new TDataGridAction(array($this, '\

25

Grids 26

34 onDelete')), 'code', 'ico_delete.png');

35

36 // creates the datagrid model

37 $this->datagrid->createModel();

38 // wrap the page content using vertical box

39 $vbox = new TVBox;

40 $vbox->add(new TXMLBreadCrumb('menu.xml', __CLASS__));

41 $vbox->add($this->datagrid);

42 parent::add($vbox);

43 }

44 /**

45 * Load the data into the datagrid

46 */

47 function onReload()

48 {

49 $this->datagrid->clear();

50

51 // add an regular object to the datagrid

52 $item = new StdClass;

53 $item->code= '1';

54 $item->name= 'Fábio Locatelli';

55 $item->address = 'Rua Expedicionario';

56 $item->fone= '1111-1111';

57 $this->datagrid->addItem($item);



60 $item->code = '2';

61 $item->name = 'Julia Haubert';

62 $item->address = 'Rua Expedicionarios';

63

64 $item->fone= '2222-2222';




68 $item->code = '3';

69 $item->name = 'Carlos Ranzi';

70 $item->address = 'Rua Oliveira';

71 $item->fone = '3333-3333';


73



Grids 27

76 $item->code = '4';

77 $item->name = 'Daline DallOglio';


79 $item->fone = '4444-4444';


81 }

82 /**

83 * method onColumnAction()

84 * Executed when the user clicks at the column title

85 */

86 function onColumnAction($param)

87 {

88 // get the parameter and shows the message

89 $key=$param['column'];

90 new TMessage('info', "You clicked at the column $key");

91 }

92 /**

93 * method onDelete()

94 * Executed when the user clicks at the delete button

95 */

96 function onDelete($param)

97 {


99 $key=$param['key'];

100 new TMessage('error', "The register $key may not be deleted");

101 }

102

103 /**

104 * method onView()

105 * Executed when the user clicks at the view button

106 */

107 function onView($param)

108 {



111 new TMessage('info', "The name is : $key");

112 }

113 /**

114 * shows the page

115 */

116 function show()

117 {

Grids 28

118 $this->onReload();

119 parent::show();

120 }

121 }

122 ?>

Essa é a TQuickGrid um grid rápida onde temos algumas , opções vamos ver parte a parte todo ocodigo. Aqui criamos a TQuickGrid e damos uma altura para ela.

1 <?php

2


4 $this->datagrid = new TQuickGrid;

5 $this->datagrid->setHeight(320);

6

7 ?>

Nessa parte colocamos os campos que iremos passar no método de carregar, onde temos addQuick-Column(label,nome da coluna,posição, tamanho, action) essa action é disparada caso o usuário clickna coluna, sem usar os botões , da grid

1 <?php

2

3 // add the columns

4 $this->datagrid->addQuickColumn('Code','code','right', 70,

5 Action(array($this, 'onColumnAction')), array('column', 'code'));

6 $this->datagrid->addQuickColumn('Name','name','left', 180,

7 Action(array($this, 'onColumnAction')), array('column', 'name'));

8 $this->datagrid->addQuickColumn('Address', 'address', 'left', 180,

9 Action(array($this, 'onColumnAction')), array('column', 'address'));

10 $this->datagrid->addQuickColumn('Phone','fone','left', 160,

11 Action(array($this, 'onColumnAction')), array('column', 'fone'));

Aqui temos as ações, para a grid, sim o botões que ficam na grid, lembrando que nessa versãopodemos usar os ícones do bottstrap, que chamarei de BT. Nas action temos View que é o label , daaction, seguido da TDataGridAction(array(class da action,nome da action),parametro,icone)

Grids 29

1 <?php

2 // add the actions

3 $this->datagrid->addQuickAction('View',new TDataGridAction(array($this, 'onView'\

4 )),'name', 'bs:search red');

5 $this->datagrid->addQuickAction('Delete', new TDataGridAction(array($this, 'onDe\

6 lete')), 'code', 'ico_delete.png');

?>

Agora onde cria a grid propriamente dita.

1 <?php

2



TQuickGrid Actions

Vamos agora ao método onde popula nossa grid, como podem ver é bem simples onde temos, aStdClass, que é um objeto genérico , assim por dianti , para mostrar para o framework basta usar onome dado a linha lembram, code,name,address,fone, dessa maneira o framework já intende oquetem que ser colocado onde.

1 <?php

2

3 <?php


5 {




9 $item->code= '1';



12 $item->fone = '1111-1111';




16 $item->code = '2';



19 $item->fone = '2222-2222';

Grids 30




23 $item->code = '3';



26 $item->fone = '3333-3333';




30 $item->code = '4';



33 $item->fone = '4444-4444';


35 }

36

37

38 ?>

Apos isso para mostrar ao carregar a pagina basta chamar o metodo que criamos, no metodo showda TPage assim ao mostrar a pagina , ele ira popular a grid.

1 <?php

2 function show()

3 {


5 parent::show();

6 }

7 ?>

Não esquecendo os métodos, que usamos nas linhas as Actions, vamos ver com cria-las, já quecolocamos as actions nas linhas ao clicar na linha , ele dispara o metodo onColumnAction que estana mesma class , que a grid por isso usado a palavra $this, na action assim indica que a ação estana mesma class que a grid. Como podem ver, em nosso métodos temos a variável $param, que énossos parametros passados na action dessa maneira conseguimos, reordenar a grid, mostrar dados,ate mesmo apagar linhas.

Grids 31

1 <?php

2

3 function onColumnAction($param)

4 {


6 $key=$param['column'];

7 new TMessage('info', "You clicked at the column $key");

8 }

Vamos ver como seria os metodos para visualizar ou excluir itens. No método , acima usamos acolumn para pegarmos, o dado da coluna, já nas actions , da grid usadas nos botões, usamos oparametro key.

1 <?php

2


4 {




8 }


10 {



13 new TMessage('info', "The name is : $key");

14 }

Estilizando as Grids È possivel alterarmos os css da grid domesmomodo que dos outros componentesisso pode ser feito atraves de css de maneira muito simples, basta mudar a class da grid para a quecriamos, lembrando que a grid é uma table sendo assim fica fácil. pode usar o parent::include, paraincluir o css caso for alterar uma única, tabela, ou pode incluir no template para alterar todas assim, basta apenas alterar as class das grids.

1 $this->datagrid->class='table-estilizada';

2 // inclui css

3 parent::include_css('app/resources/custom-table.css');

TDataGrid

Vamos agora ver como funciona uma grid mais complexa, temos a TDataGrid bem simples de usar.Bem semelhante a TQuickGrid porem, nessa podemos facilmente colocar um grupo de botões de

Grids 32

opção ao invés de colocarmos como na grid de TQuickGrid, temos então a TDataGrid, sem nem umaalteração a diferença é que suas Actions sem mais detalhadas e mais facil de passar parâmetros.

Lembrando que temos a opção de usar o bootstrap e de deixar a grid responsiva

DatagridActionGroupView

1 <?php

2 class DatagridActionGroupView extends TPage

3 {



6 {



9 $this->datagrid = new TDataGrid;

10 // create the

11 $code = new TDataGridColumn('code','Code','right',50);

12 $name = new TDataGridColumn('name','Name',left,100);

13 $address = new TDataGridColumn('address','Adddress',left,100);

14 $telephone = new TDataGridColumn('fone','Fone',left,100);

15

16 // add the columns to the datagrid

17 $this->datagrid->addColumn($code);

18 $this->datagrid->addColumn($name);

19 $this->datagrid->addColumn($address);

20 $this->datagrid->addColumn($telephone);

21

22 // creates two datagrid actions

23 $action1 = new TDataGridAction(array($this, 'onView'));

24 $action1->setLabel('View name');

25 $action1->setImage('bs:search blue');

26 $action1->setField('name');

27 $action2 = new TDataGridAction(array($this, 'onDelete'));

28 $action2->setLabel('Try to delete');

29 $action2->setImage('bs:remove red');

30 $action2->setField('code');


32 $action3->setLabel('View address');

33 $action3->setImage('bs:hand-right green');

34 $action3->setField('address');

35 $this->datagrid->addAction($action1);



Grids 33



40 parent::add($this->datagrid);

41 }

42 /**


44 */


46 {


48



51 $item->code = '1';



54 $item->fone= '1111-1111';





59 $item->name= 'Julia Haubert';


61 $item->fone= '2222-2222';





66 $item->name= 'Carlos Ranzi';


68 $item->fone= '3333-3333';




72 $item->code = '4';

73 $item->name= 'Daline DallOglio';


75 $item->fone= '4444-4444';


77 }

78 /**


Grids 34


81 */


83 {



86


88 }

89 /**



92 */


94 {



97 new TMessage('info', "The information is : $key");

98 }

99 /**


101 */

102 function show()

103 {


105 parent::show();

106 }

107 }

108 ?>

Podemos colocar um grupo de opções juntos, sem ter que alterar muita coisa. basta tirar o $this->datagrid->addAction.

Grid com Componentes de formulário

Podemos , usar componentes de formularios na grid , dessa forma fica facil editar, ou ate mesmoselecionar, vamos usar a mesma class acima, e apenas altera-la.

Grids 35

DatagridActionGroupViewForm

1 <?php

2 class DatagridActionGroupViewForm extends TPage

3 {


5 private $form;


7 {



10 $this->datagrid = new TDataGrid;

11 $this->form = new TForm('progs');

12 $btnSalvar = TButton::create('salvar',array($this,'onSave'),'salvar','bs\

13 :user');

14 //cria box para organizar os itens

15 $box = new TVBox();

16 $box->add($this->datagrid);

17 $box->add($btnSalvar);

18 $this->form->add($box);

19

20 $this->form->addField($btnSalvar);

21 // create the datagrid columns

22 $code = new TDataGridColumn('code','Code','right',50);

23 $name = new TDataGridColumn('name','Name',left,100);

24 $address = new TDataGridColumn('address','Adddress',left,100);

25 $telephone = new TDataGridColumn('fone','Fone',left,100);

26 // add the columns to the datagrid

27 $this->datagrid->addColumn($code);

28 $this->datagrid->addColumn($name);

29 $this->datagrid->addColumn($address);

30 $this->datagrid->addColumn($telephone);

31 // creates two datagrid actions





36

37 $action2 = new TDataGridAction(array($this, 'onDelete'));

38 $action2->setLabel('Try to delete');

39 $action2->setImage('bs:remove red');

40 $action2->setField('code');

41

Grids 36


43 $action3->setLabel('View address');

44 $action3->setImage('bs:hand-right green');

45 $action3->setField('address');

46

47

48 $action_group = new TDataGridActionGroup('Actions', 'bs:th');

49 $action_group->addHeader('Available Options');

50 $action_group->addAction($action2);

51 $action_group->addSeparator();

52 $action_group->addHeader('Another Options');

53

54 $action_group->addAction($action3);

55 // add the actions to the datagrid

56 $this->datagrid->addActionGroup($action_group);



59 parent::add($this->form);

60 }

61 /**


63 */


65 {






71 $item->address = new TEntry('anddress1'); // coloca um TENtry

72 $item->address->setValue('Rua Expedicionario'); // seta o valor

73 $item->fone= '1111-1111';


75 $this->form->addField($item->address);

76 }

77 /**



80 */


82 {


Grids 37



86 }

87

88 /**



91 */


93 {



96 new TMessage('info', "The information is : $key");

97 }

98 function onSave(){

99 }

100 /**


102 */

103 function show()

104 {


106 parent::show();

107 }

108 }

109 ?>

Observem que colocamos um form , e dentro dele a TGrid, apos isso basta no metodo onde carregaa TGrid passarmos o componente e seu valor.

Email e Telefone Edit



3 $item->code= '1';



6 $item->fone= '1111-1111';




10 $item->code = '2';


Grids 38


13

14 $item->fone= '2222-2222';




18 $item->code = '3';



21 $item->fone = '3333-3333';


23



26 $item->code = '4';



29 $item->fone = '4444-4444';


31 }

32 /**

33 * method onColumnAction()

34 * Executed when the user clicks at the column title

Pode-se usar qualquer componente usado em formulário, desde que se passa seu valor.

Condições para OpçõesComo essa nova versão é bem interessante , para controle de permissão não é preciso usar if nomeio do codigo, podemos usar condições que podem ou não mostrar as opções desde que tenhamum rollback Usando o codigo a cima, basta alterar uma action , inserindo a propriedade que irachecar se deve ou não ser exibida.

1 <?php

2

3 // creates datagrid actions





8 $action1->setDisplayCondition(array($this,'verifica')); // verifica se deve ser \

9 exibida

10

11 ?>

Para mostrar se é possivel ou não, mostrar o item basta fazer uma comparação e retornar uma valorboolean, assim se for falso o retorno ele não exibe, se for verdadeira é que o item dever ser exibido.

Email e Telefone Edit


2 {


4



7 $item->code= '1';



10 $item->fone= '1111-1111';




14 $item->code = '2';


39

Condições para Opções 40


17

18 $item->fone= '2222-2222';




22 $item->code = '3';



25 $item->fone = '3333-3333';


27



30 $item->code = '4';



33 $item->fone = '4444-4444';


35 }

1 <?php

2

3

4 public function verifica( $object )

5 {

6 if ($object->code > 1 )

7 {

8 return TRUE;

9 }

10 return FALSE;

11 }

Documents

Adianti Framework 3 - Leanpubsamples.leanpub.com/adiantiframeworknapratica-sample.pdfOqueéAdiantiFramework O Adianti framework é um framework desenvolvido pela Adianti Solutions