- Criado por Igor Andrade em 02/12/2018
Você está vendo a versão antiga da página. Ver a versão atual.
Comparar com o atual Ver Histórico da Página
Versão 1 Próxima »
Função
A grade é um componente de tabela poderoso e muito customizável. Em suas configurações é possível... (deixar isso pro final)
FAZENDO NO NOVO AMBIENTE...
Uso
Principais propriedades
Nome | propriedade | função |
---|---|---|
Configurações | options | Abre a janela de configurações da grade. |
Segurança | cronapp-security | Abre a janela que seleciona os grupos com permissões para visualizar ou editar do conteúdo da grade. |
Configurações
A propriedade Configurações abre a janela de Opções da Grade, nela podemos realizar diversas personalizações, como: indicar a(s) fonte(s) de dados, configurar modelo de grade, definir e configurar cada coluna, alterar o modo de edição e adição de itens, adicionar botões com funcionalidades personalizadas, alterar template e mais outras tantas funcionalidades.
No item (1) da Figura 1.1, temos a área de detalhes com o Master (principal e que não pode ser excluído) e o Novo, criado posteriormente. Cada detalhe pode ser responsável por personalizar uma grade, sendo possível definir Modelos (2) e as configurações das abas (3) para cada uma delas ou vincular duas fontes de dados a uma mesma grade. Com os detalhes é possível adicionar uma subgrade a uma grade, permitindo por exemplo que em uma grade de funcionário, cada linha tenha uma subgrade com os seus dependentes ou, ao invés de exibir uma subgrade com a lista de dependentes, criar uma nova coluna com o número total de dependentes de cada funcionário, dado que seria obtido em um detalhe distinto e vinculado a Master.
Na Figura 1.1 mostrando as áreas de configuração da janela Opções da Grade.
Figura 1.1 - Janela de Opções da Grade
- Detalhes: permite selecionar cada detalhe e configurá-los separadamente, além de adicionar e remover detalhes. O Master não pode ser removido.
- Modelos: é possível selecionar modelos pré configurados de grade ou de customização. Temos cinco opções:
- Editável simples: (Ver a diferença).....
- Editável completa: (Ver a diferença).....
- Listagem simples: exibe os itens como em uma tabela, permitido apenas ordenação por coluna;
- Listagem completa: exibe os itens como em uma tabela, mas possui funcionalidades como: paginar, ordenar, agrupar, atualizar grade e outros;
- Customizado: permite a personalização de todos os componentes da grade;
- Abas de customização: toda a personalização da grade é feita nessa área. Abaixo detalharemos o conteúdo de cada uma das abas.
Aba Geral
A aba Geral (item (3) da Figura 1.1) define as configurações mais amplas da grade, como fonte de dados, tamanho e modo de edição.
- Fonte de dados: seleciona uma fonte existente na view, cria uma nova fonte de dados ou edita a fonte selecionada;
- Altura: define a altura da grade na página em número de pixel e aceita somente valores numéricos;
- Editável: informa se os itens poderão ser editáveis e como ocorrerá essa edição. As possibilidades são:
- Não: não é possível editar ou excluir itens da grade e os botões são ocultos da grade;
- Em linha: a adição ou edição ocorre na própria linha da grade;
- Pop up: um pop é aberto com os campos para inserção ou edição do item selecionado;
- Pop up customizado: habilita os campos Pop up inserção e Pop up edição;
- Pelo Datasource: a grade é oculta da tela e os campos de entrada de texto são exibidos na tela para edição ou adição, assim como ocorre nas páginas de CRUD no Cronapp;
- Pop up inserção: são exibidos os modais criados pelo usuário na view, dessa forma o usuário pode personalizar a inserção de item.
- Pop up edição: são exibidos os modais criados pelo usuário na view, dessa forma o usuário pode personalizar a edição de item.
- Permite selecionar linha: quando habilitado, ao clica em uma linha a mesma ficará marcada após o cursor do mouse não está mais em cima do item.
Aba Exibição
A aba de Exibição habilita ou desabilita algumas funcionalidades da grade.
Figura 1.2 - Aba que habilita alguns de itens a serem exibidos na grade.
- Permitir paginar: realiza a paginação dos itens, informando a página atual e botões para avançar e retroceder a lista;
- Permitir ordenar: possibilita ordenar a lista baseada na coluna selecionada. O primeiro clique no cabeçalho da coluna ordena de forma crescente, o seguindo clique de forma decrescente e o terceiro retorna a ordenação da fonte de dados. A coluna ordenada além de exibir setas (↑ e ↓) ao lado do título no cabeçalho, fica em um tom mais escuro, destacando qual coluna está ordenando a grade.
- Permitir agrupar: gera agrupamento das colunas selecionadas, basta clicar e arrastar o cabeçalho de uma das coluna para a área logo acima da do cabeçalho;
- Permitir atualizar grade: adiciona botão para atualização da grade sem a necessidade de carregar a página inteira;
- Permitir seleção do total de páginas a exibir: (Ver a diferença).....
Aba Barra de ferramenta
- Sem rótulos