Função

Esse componente é usado para renderizar os dados de uma coluna da tabela. O listar dados dinâmicos através do vínculo com uma fonte de dados. Além disso, a lista com swipe permite que o usuário tenha a possibilidade de realizar uma ação realize ações através dos botões que aparecem após arrastar um dos itens da lista para esquerda o componente.

Image Removed

Image Added

Figura 1.1 - Exemplo de imagem da Lista com swipe rodando no Aplicativo

Principais propriedades

Na tabela abaixo estão descritos 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 swipe

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 Added

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 Added

Figura 2.2 - Execução da Lista com swipe configurada da figura 2.1

Subcomponente Item

Para mais detalhes, acesse a documentação do componente Botão.

Configuração

Adicionar novo item / Remover um item

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.Para adicionar um novo item, basta clicar no botão + (1 da Figura 2.1). Para remover um item, basta clicar no ícone da lixeira que pertencente a esse item (Figura 2.1).

Image Modified

Figura 2.1 2 - Adicionar ou remover um botão do item da lista

Adicionar novo botão / Remover um botão

O botão corresponde ao item, e cada item pode ter mais ou menos botões que os outros. Para adicionar ou remover um botão, selecione o item desejado da lista com swipe na propriedade item. Após selecionado, na propriedade itens do item faz a adição (1 da Figura 2.2) ou remoção de um botão (Figura 2.2). Por padrão, o item apresenta os botões de editar e deletar.

Image Removed

Subcomponente Botão

Para mais detalhes, acesse a documentação do componente Item.

Vincular fonte de dados ao componente

O funcionamento básico do componente é através do vínculo de uma fonte de dados com o componente. Assim, insera e configure a fonte de dados na área de design, e após, adicione a lista com swipe e, em propriedades, selecione para fazer o vínculo (Figura 2.3) dessa fonte com o componente.

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 Removed

Image Added

Figura 2.4 - Víncular dados ao componente