Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Introdução
Gráficos são elementos bastante utilizados para apresentar informações de uma maneira mais compreensível e amigável, eles são indicados principalmente quando trabalham com dados numéricos. Sua utilização na IDE se dá através da combinação entre O Cronapp permite gerar gráficos dinâmicos utilizando os blocos de programação da categoria gráfico e o componente visual gráfico, e eles são os responsáveis, respectivamente, por criar um gráfico e o renderiza-lo em uma view HTML.
Pré-configuração
Será feito em etapas, primeiramente adicionando o componente na IDE e, após, desenvolvendo uma programação simples utilizando o bloco gráfico onde o mesmo utilizará dados de um bancoexistentes em projetos web e mobile.
Âncora | ||||
---|---|---|---|---|
|
Image Added
Figura 1 - Gráfico sendo executado no browser
Pré-configuração
- Crie um projeto do tipo web ou mobile, Caso tenha dúvidas de como criar esse tipo de projeto, acesse o link ( Criar projeto );
- Gere uma entidade no diagrama de dados (passo abaixo) e
- Alimente a base de dados (passo abaixo).
Criando uma entidade no banco
- Adicione uma classe no diagrama - nesse exemplo, vai ser utilizado será utilizada a classe anime;.
- Crie atributos para essa classe, como anime (tipo texto), genero gênero (tipo texto), episódios (tipo inteiro) e ano (tipo texto*) (Figura 2).1);
- Gere a Faça a persistência da classe clicando com o botão direito do mouse sobre a classe e selecionando criar camada de dados para a entidade (Figura 2.1);Crie o formulário da classe clicando com o botão direito do mouse sobre a classe e selecionando e o CRUD, através da opção criar visão para a entidade (Figura 2.1).).
* Nesse exemplo estamos utilizando o tipo do campo ano como Texto para simplificar.
Image AddedImage Removed
Figura 2 .1 - Criar persistência e visão para a entidade
Vinculando página à barra de navegação e adicionando dados
Após, vincule a página na barra de navegação da página homeAlimentando a base de dados
Rode o projeto, acesse a página CRUD anime gerada no passo anterior e alimente a tabela inserindo itens na grade. (Figura 2.
21)
reproduzindo os passos abaixo:Image Added
Figura 2.1 - Inserindo registros na tabela
Configuração do Gráfico
A configuração do gráfico será feita em duas etapas: adição do componente em um formulário e a criação de um bloco de programação simples, alimentado por banco de dados.
Componente visual
Em um formulário (web ou mobile), arraste o componente gráfico, selecione-o e na aba propriedade
- Abra a view home.view.html;
- Selecione a barra de navegação para abrir a janela Opções de Menu - caso ela não abra, clique no botão "..." (indicado pela seta vermelha na Figura 2.2) do campo configuração pertencente a aba propriedade;
- Adicione um novo item a barra (1 da Figura 2.2) e insira um nome;
- No botão "..." (2 da Figura 2.2) pertencente ao campo ação para abrir a janela de view e selecione a view da classe que foi gerada;
Image Removed
Figura 2.2 - Vinculando página à barra de navegação
Execute o projeto e adicione dados aleatórios, mas sempre preenchendo em todos os campos.
Adicionando componente visual
Na página da home.view.html adicione o componente gráfico. Selecione o componente e na aba propriedade, altere o conteúdo do campo identificador do gráfico para chartAnime e "chartAnime", facilitando a identificação, salve a página.
Image RemovedImage Added
Figura 3 - Alterando o campo identificador do gráfico
Criando o blocoBloco de programação
Os blocos de gráficos existem tanto no lado cliente (web ou mobile) quanto no lado servidor. Utilizaremos os blocos do lado servidor por conta dos blocos de consulta ao banco de dados.
Vinculando página ao bloco
Crie um bloco de programação do tipo servidor e ao abrir a janela, vincule a página home na qual arrastamos o gráfico com o bloco de programação (Figura 4.1) seguindo os passos abaixo:
Image Added
Figura 3.1 - Vinculando página HTML ao bloco de programação
- Clique na engrenagem do bloco de programação;
- Clique no botão "..." que fica ao lado do campo formulário de referência;
- Selecione o formulário que contém o componente gráfico, nesse exemplo: página home.
Image Removed
Figura 4.1 - Vinculando página html ao bloco de programação
Programação do bloco gráfico
Primeiro, adicione o bloco criar gráfico e no parâmetro ID, selecione chartAnime para vincular o bloco com o componente.- view.html da pasta logged.
Bloco criar gráfico
O bloco criar gráfico é responsável por vincular o id do componente visual gráfico, selecionar o tipo do gráfico a ser exibido, receber as séries e suas respectivas legendas. Para mais informações, acesse a documentação do bloco.
- Arraste o bloco criar gráfico, da categoria Gráfico, e adicione na Função.
- No parâmetro Id, selecione a opção que demos ao id do componente gráfico, nesse exemplo foi chartAnime.
- No parâmetro tipo de gráfico, selecione a opção bar (gráfico em barras).
Image RemovedImage Added
Figura 43.2 - Adicionando Vinculando o bloco criar gráfico e realizando as primeiras configuraçõesao componente visual e selecionando o tipo de gráfico
Após isso, adicione
- Adicione o bloco abrir consulta, da categoria banco de dados, e encaixe-o
- dentro do bloco Converter valor para, após isso, arraste o bloco para o parâmetro legenda.
- Clique na engrenagem (indicado pela seta vermelha na Figura
- 3.3) para abrir a janela de configuração do bloco
- :
- Selecione a entidade anime;
- Escolha o campo ano;
- Agrupe os dados pelo campo ano
- .
Image RemovedImage Added
Figura 43.3 - Configurando o bloco para o parâmetro legenda
Por fim, adicioneBloco criar série
Uma série é um conjunto de valores de um mesmo elemento, responsável por quantificar visualmente o gráfico. Em um gráfico do tipo barra, o parâmetro Legenda do bloco criar gráfico alimentará os índices do eixo x, já o bloco criar série vai alimentar o desenho e as legendas do eixo y (Figura 3.4).
Acesse a documentação do Bloco para mais informações.
- Arraste o bloco criar série
- , categoria gráfico
- , e encaixe no parâmetro série(s) do gráfico do
- bloco criar gráfico.
- Encaixe um bloco texto no parâmetro nome da série
- e o nomeie como Qtd lançadas
- .
- Adicione outro bloco abrir consulta
- , categoria Banco de dados, e encaixe-o dentro do bloco Converter valor para, após isso, arraste o bloco para o parâmetro Dados e clique na engrenagem desse bloco para abrir a janela de configuração
- :
- Adicione a entidade
- Anime;
- Na área campos, selecione a opção COUNT na primeira caixa de seleção e depois selecione o campo a.anime
- ;
- Agrupe os dados por a.ano.
Image RemovedImage Added
FIgura 4Figura 3.4 - Configurando o bloco para o parâmetro dados do bloco criar série
Parâmetro opções
Esse parâmetro define algumas personalizações ao gráficopropriedades personalizáveis do gráfico e de suas séries, como adicionar título, definir animações no ao gráfico, alterar o layout e entre outros, mas essa personalização é através do código javascript e sua estrutura é conforme o exemplo abaixo e que é utilizado no bloco texto, encaixada no parâmetro opções (Figura 4.5).
Image Removed
.
Informações | ||
---|---|---|
| ||
Para mais informações, acesse os links abaixo: Animação, Layout, Legenda, Título, Tooltip e Elementos. |
A estrutura de configuração para o parâmetro opções é em formato JSON, formato de representação de dados que é composto basicamente de chave/valor. Por exemplo, no código abaixo, a propriedade title se refere ao título do gráfico e as combinações de chave/valor estão dentro dessa propriedade - delimitada por {}. Veja o que representa cada chave da propriedade title:
- "display": true - habilita a visualização do título no gráfico;
- "text": "Animes assistido por ano" - define o conteúdo para o título;
- "fontSize": 20 - define o tamanho do título;
- "fontColor": "#00F" - cor para o título.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "title": { "display": true, "text": "Animes assistidoassistidos por ano", "fontSize": 20, "fontColor": "#00F" }, "legend": { "display": true }, "animation": { "duration": 1500, "easing": "easeOutBounce" }, "layout": { "padding": { "left": 120, "right": 120, "top": 60, "bottom": 60 } } } |
Sendo assim, adicione o bloco texto e o encaixe no parâmetro opções do bloco Criar gráfico (Figura 3.5). Copie o código apresentado acima para ver as personalizações que ocorrem no gráfico.
Image Added
Figura 3.5 - Personalização do gráfico
Vinculando bloco ao evento do gráfico
De volta ao formulário no qual o componente gráfico se encontra presente:
- Selecione o componente e na aba propriedades, selecione a subaba eventos;
- Clique em exibir mais e selecione o botão "..." do evento ao iniciar para abrir a janela de seleção de eventos;
- Na aba Bloco de Programação, clique no botão "..." e selecione a função que criamos acima (Figura 4).
Image Added
Figura 4 - Vinculando bloco ao componente gráfico
Por fim, execute novamente o projeto e acesse a página para visualizar o gráfico (Figura 1).
Nessa página
Índice |
---|