Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Função
Esse componente é usado para listar dados dinâmicos através do vínculo com uma Listas com deslizar são componentes Item com deslizar vinculados a um Componente visual fonte de dados, permitindo associar o conteúdo da lista com registros da fonte de dados. Além disso, a lista com swipe deslizar permite que o usuário realize ações através dos botões que aparecem após arrastar um dos itens da lista para esquerda o componente.Image Removeddo componente, é preciso configurar alguma ação para que esses botões funcionem.
Image Added
Figura 1 .1 - Exemplo da Lista com swipe deslizar rodando no Aplicativoaplicativo
Principais propriedades
Na tabela abaixo estão descritos descritas as principais propriedades para o funcionamento básico do componente. Estão descritos tanto para a funcionalidade da lista com swipe em si quanto para os itens dessa lista e os botões.
Lista com
swipedeslizar
Nome | Propriedade | Função |
---|---|---|
Fonte de dados | crn-datasource | Seleciona uma fonte de dados presente no formulário html. |
Identificador | id | Gera um ID automaticamente para o componente, mas que pode ser alterado. |
Estilo | style | Altera o estilo do componente de forma inline. |
Exibir | ng-show | Propriedade AngularJS Angular usada para mostrar ou oculta o componenteocultar o componente. |
Repetir | crn-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. |
Segurança | cronapp-security | Abre a janela de seleção dos grupos com permissões para visualização ou edição. |
Skin | crn-skin | Permite selecionar um skin que afetará apenas o componente selecionado. |
Classes CSS | class | Adiciona classes CSS que já foram criadas. |
Itens | - | Define a quantidade de Itens e acessa as configurações desses Itens. |
O componente Lista com swipe é composta pelo subcomponente Item, que por sua vez é composto pelo subcomponente Botão. Dessa forma, ao selecionar a Lista com swipe é possível acessar a propriedade Itens, adicionando novos Item e selecionando esse subcomponente Item, é possível acessar a propriedade Itens, adicionando novos subcomponentes Botão.
propriedade itens da Lista
Após selecionar uma fonte de dados (propriedade Fonte de dados) é necessário apenas 1 item configurado com um dos campos da fonte de dados para exibir uma lista de registros. A adição de novos itens na Lista com swipe é usada para mesclar conteúdos na lista, exibindo outro campo da fonte de dados ou um conteúdo estático.
A propriedade Itens permite adicionar subcomponente Item na Lista (1 da Figura 2.1), excluir (2 da Figura 2.1), alterar a ordem de exibição desses subcomponentes (3 da Figura 2.1) e ao clicar sobre o item, é possível acessar suas configurações. A configuração de cada Item é independente, permitindo botões com ações distintas para cada Item.
Image Removed
Figura 2.1 - Propriedade Itens da Lista
No exemplo da Figura 2.1, o primeiro Item possui o campo "name" da fonte de dados associada e o segundo possui o texto estático "Item intermediário". Ao executar, é possível notar que a Lista com swipe intercala entre um nome da fonte de dados e um item com o texto estático (Figura 2.2). Dessa forma, para cada registro da fonte de dados, será exibido um item com o texto estático "Item intermediário".
Image Removed
Figura 2.2 - Execução da Lista com swipe configurada da figura 2.1
Subcomponente Item
Dica |
---|
Para mais detalhes sobre propriedades não descritas acima |
, acesse a documentação do componente |
Item com deslizar. |
Nome
Propriedade
Função
Conteúdo
content
Campo para definir o conteúdo a ser mostrado pelo componente. Esse é o campo que seleciona a coluna da tabela.
Classes CSS
class
Adiciona classes CSS que já foram criadas.
Exibir
ng-show
Propriedade AngularJS usada para mostrar ou oculta o componente.
Identificador
id
Gera um ID automaticamente para o componente, mas que pode ser alterado.
Segurança
cronapp-security
Abre a janela de seleção dos grupos com permissões para visualização ou edição.
Aba de Estilos
Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente lista com deslizar.
Nome em português | Nome em inglês | Descrição |
---|---|---|
Plano de fundo | Background | Estiliza o plano de fundo do componente. |
Título | Label | Estiliza o texto do componente. |
Botão de Editar | Edit Button | Estiliza o botão de editar |
Botão de Excluir | Delete Button | Estiliza o botão de deletar |
Vincular fonte de dados
Propriedade itens do Item
A propriedade itens do subcomponente Item é responsável por organizar os botões que são exibidos ao deslizar o registro da lista para esquerda. Para configurar esta propriedade, é necessário selecionar um dos subcomponentes Item na propriedade itens da Lista com swipe.
Image Removed
Figura 2.2 - Adicionar ou remover um botão do item
Subcomponente Botão
Para mais detalhes, acesse a documentação do componente Item.
Nome
Propriedade
Função
Ícone
class
Abre a janela de seleção do ícone.
Conteúdo
content
Define o rótulo.
Tema
xattr-theme
Altera o tema (cor) do preenchimento do botão.*
O funcionamento básico do componente é através do vínculo de uma fonte de dados com o componente. Assim, insera insira e configure a o Componente visual fonte de dados na área de design, e após isso, adicione a lista com swipe e, em propriedades, selecione para fazer o vínculo (Figura 2.3) dessa fonte com o componente.
Image Removedo componente Lista com deslizar e selecione a fonte de dados que será utilizada no componente.
Image Added
Figura 2 - Vincular Figura 2.3 - Víncular fonte de dados existente no formulário ao componente
Vincular dados da fonte ao componente
Para vincular os dados da fonte ao componente, clique sobre o item e clique em … ao lado do campo conteúdo para abrir a janela de configuração do conteúdo. Assim, selecione a aba campo de tela e escolha qual das colunas dessa fonte mostrará os dados no componente (Figura 2.4).
Image RemovedFigura 2.4 - Víncular dados ao componente
Itens
Após selecionar uma Fonte de dados (propriedade Fonte de dados) é necessário apenas 1 item configurado com um dos campos da fonte de dados para exibir uma lista de registros. Para fazer essa configuração, vá na propriedade Itens e clique no subcomponente Item para fazer sua seleção e, assim, poder abrir a janela de conteúdo e fazer o vínculo do conteúdo com um campo da fonte de dados.
Image Added
Figura 2.1 - Vincular dados ao componente
Ao clicar no botão "+" (Adicionar) da propriedade "Itens", do componente Lista com deslizar, será incluído um novo componenteItem com deslizar (subcomponente) que é vinculado a um registro da fonte de dados (Figura 2.1). Clique sobre o novo Item (destaque 1 da figura 2.2) para selecionar e configurar somente o novo Item. Para retornar as configurações da Lista com deslizar, clique fora da área selecionada na área de edição.
Para reordenar os itens, clique e arraste (2) ou clique no ícone da lixeira para excluir o item.
Image Added
Figura 2.2 - Propriedade Itens da Lista
Após configurar um registro da propriedade Itens, o componente será visualizado como na figura abaixo.
Image Added
Figura 2.3 - Lista com deslizar com novo registro na propriedade itens
Nome em inglês
Swipe List
Nome em inglês
List Swipe
Nessa página
Índice maxLevel 3 printable false
Compatibilidade
Formulário mobile
Equivalente web / mobile
Não possuiO link será adicionado no final, após todos os componentes criados.
Botão do Componente
Image RemovedImage Added
Imagem no Editor Visual
Image RemovedImage Added