Xamarin.Forms CollectionView Introdução

  • Artigo

CollectionView é uma exibição para apresentar listas de dados usando especificações de layout diferentes. O objetivo é fornecer uma alternativa mais flexível e eficiente ao ListView. Por exemplo, as capturas de tela a seguir mostram um que usa uma grade vertical de CollectionView duas colunas e que permite seleção múltipla:

Captura de tela de um layout de grade vertical CollectionView no iOS e Android

CollectionView deve ser usado para apresentar listas de dados que exigem rolagem ou seleção. Um layout vinculável pode ser usado quando os dados a serem exibidos não exigem rolagem ou seleção. Para obter mais informações, consulte Layouts vinculáveis no Xamarin.Forms.

CollectionView está disponível a partir da Xamarin.Forms versão 4.3.

Importante

CollectionView está disponível no iOS e Android, mas está apenas parcialmente disponível na Plataforma Universal do Windows.

Diferenças entre CollectionView e ListView

Embora as APIs e ListView sejam CollectionView semelhantes, existem algumas diferenças notáveis:

  • CollectionView Possui um modelo de layout flexível, que permite que os dados sejam apresentados vertical ou horizontalmente, em uma lista ou grade.
  • CollectionView suporta seleção única e múltipla.
  • CollectionView não tem conceito de células. Em vez disso, um modelo de dados é usado para definir a aparência de cada item de dados na lista.
  • CollectionView Utiliza automaticamente a virtualização fornecida pelos controles nativos subjacentes.
  • CollectionView reduz a superfície da API do ListView. Muitas propriedades e eventos de ListView não estão presentes no CollectionView.
  • CollectionView não inclui separadores integrados.
  • CollectionView lançará uma exceção se ela ItemsSource for atualizada fora do thread da interface do usuário.

Mover de ListView para CollectionView

ListView As implementações em aplicativos existentes Xamarin.Forms podem ser migradas para CollectionView implementações com a ajuda da tabela a seguir:

Conceito API de ListView CollectionView
Dados ItemsSource A CollectionView é preenchido com dados definindo sua ItemsSource propriedade. Para obter mais informações, consulte Preencher um CollectionView com dados.
Aparência do item ItemTemplate A aparência de cada item em um CollectionView pode ser definida definindo a ItemTemplate propriedade como um DataTemplatearquivo . Para obter mais informações, consulte Definir a aparência do item.
Cells TextCell, ImageCell, ViewCell CollectionView não tem conceito de células e, portanto, não tem conceito de indicadores de divulgação. Em vez disso, um modelo de dados é usado para definir a aparência de cada item de dados na lista.
Separadores de linha SeparatorColor, SeparatorVisibility CollectionView não inclui separadores integrados. Estes podem ser fornecidos, se desejado, no modelo de item.
Seleção SelectionMode, SelectedItem CollectionView suporta seleção única e múltipla. Para obter mais informações, consulte Xamarin.Forms CollectionView Selection.
Altura da linha HasUnevenRows, RowHeight Em um CollectionView, a altura da linha de cada item é determinada pela ItemSizingStrategy propriedade. Para obter mais informações, consulte Dimensionamento de itens.
Cache CachingStrategy CollectionView usa automaticamente a virtualização fornecida pelos controles nativos subjacentes.
Cabeçalhos e rodapés Header, HeaderElement, HeaderTemplate, Footer, , FooterElementFooterTemplate CollectionView pode apresentar um cabeçalho e rodapé que rolam com os itens na lista, por meio das Headerpropriedades , Footer, HeaderTemplatee FooterTemplate . Para obter mais informações, consulte Cabeçalhos e rodapés.
Agrupamento GroupDisplayBinding, GroupHeaderTemplate, GroupShortNameBinding, IsGroupingEnabled CollectionView exibe dados agrupados corretamente definindo sua IsGrouped propriedade como true. Os cabeçalhos e rodapés de grupo podem ser personalizados definindo as GroupHeaderTemplate propriedades e GroupFooterTemplate como DataTemplate objetos. Para obter mais informações, consulte Xamarin.Forms Agrupamento CollectionView.
Deslizar para atualizar IsPullToRefreshEnabled, IsRefreshing, RefreshAllowed, RefreshCommand, , RefreshControlColor, BeginRefresh(), EndRefresh() A funcionalidade pull to refresh é suportada definindo um CollectionView como filho de um RefreshViewarquivo . Para obter mais informações, consulte Pull to refresh.
Itens de menu de contexto ContextActions Os itens de menu de contexto são suportados definindo um SwipeView como o modo de exibição raiz no que define a DataTemplate aparência de cada item de dados no CollectionView. Para obter mais informações, confira Menus de contexto.
Rolagem ScrollTo() CollectionView define ScrollTo métodos, que rolam itens para a exibição. Para obter mais informações, consulte Rolagem.