Função
Esse componente é usado para listar ícones e dados estáticos ou dinâmicos, através do vínculo com uma fonte de dados.
Figura 1.1 - Exemplo da Lista com ícone rodando no Aplicativo
Principais propriedades
Na tabela abaixo estão descritas as principais propriedades para o funcionamento básico do componente.
Nome | Propriedade | Função |
|---|---|---|
Fonte de dados | crn-datasource | Seleciona uma fonte de dados que estiver presente no formulário html. |
Ícone | class | Abre a janela de seleção de ícones. |
Conteúdo | content | Esse campo define o texto que é exibido. |
Repetidor | ng-repeat | Propriedade que seleciona uma fonte de dados contida na tela e repete o componente baseado no número de itens dessa fonte de dados. |
Posição do texto | xattr-text-position | Define a posição do conteúdo, alinhando à esquerda, centro ou direita. |
Posição do ícone | xattr-position | Define a posição do ícone, alinhando à esquerda ou direita. |
Tema do conteúdo | xattr-theme | Define o tema do texto. |
Tema do ícone | xattr-theme | Define o tema do ícone. |
Identificador | id | Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente. |
Exibir | ng-show | Propriedade AngularJS usada para mostrar ou oculta o componente. |
Segurança | cronapp-security | Propriedade do Cronapp que trata as permissões de segurança da aplicação. Usado para permitir ou não edição e visualização do componente com base nos perfis selecionados. |
Classes CSS | class | Adiciona classes CSS que já foram criadas. |
| Itens | - | Permite adicionar, ordenar, configurar e excluir itens estáticos na lista. |
Fonte de dados
O componente necessita de uma fonte de dados para funcionar. Dessa forma, insira e configure a fonte de dados na área de design, e após, selecione o datasource no campo Fonte de dados para fazer o vínculo (Figura 2.1).
Figura 2.1 - Vinculando fonte de dados existente no formulário ao componente
Conteúdo
Após o vínculo da fonte de dados, na propriedade exibida acima, clique no botão "..." da propriedade Conteúdo para abrir sua janela, acesse a aba Campo da Tela e selecione um dos campos da Fonte de dados para ser exibido na lista (Figura 2.2).
Figura 2.2 - Seleção do campo da Fonte de dados
Ícone
Ao clicar no campo da propriedade Ícone, uma janela de seleção de ícones é aberta. Selecione o ícone desejado (Figura 2.3).
Figura 2.3 - Alterando o ícone do componente
Itens
A Lista com ícone permite adicionar itens sem relação com a Fonte de dados, porém esse item inserido manualmente será exibido antes ou após cada item da fonte de dados.
Para utilizar essa propriedade, selecione o componente Lista com ícone e role a barra de rolagem das propriedades (menu direito) até o final para visualizar um único item. Para adicionar outros, clique no botão "+" (1 da figura 2.4) e outro item aparecerá. Clique, segure e arraste o novo item (3) para alterar a sua posição na lista. Apague um item usando o botão da lixeira (2).
Figura 2.4 - Configuração da propriedade Itens
Clique sobre o item para selecioná-lo. Após isso, a seleção (contorno tracejado em azul) ficará somente sobre o item selecionado e seu botão bolha cadeado (1 da figura 2.5) estará aberto, dessa forma, as propriedades exibidas no menu lateral pertencem somente a esse item.
Para retornar as propriedades do componente Lista com ícone, clique no botão bolha cadeado até que a seleção fique em volta do componente e o ícone do cadeado esteja fechado.
Figura 2.5 - Seleção e propriedades de um dos itens da Lista com ícone
Após rodar o projeto com as configurações acima, será possível visualizar o item adicionado após cada um dos dois registros da Fonte de dados.
Figura 2.6 - Resultado das configurações
Nome em inglês
Icon List
Nessa página
Compatibilidade
Formulário mobile
Equivalente web
Botão do Componente
Imagem no Editor Visual