Xamarin.Forms Listview

Download Sample Pobieranie przykładu

ListView to widok do prezentowania list danych, szczególnie długich list wymagających przewijania.

Ważne

CollectionView to widok do prezentowania list danych przy użyciu różnych specyfikacji układu. Ma na celu zapewnienie bardziej elastycznej i wydajnej alternatywy dla ListViewprogramu . Aby uzyskać więcej informacji, zobacz Xamarin.Forms CollectionView.

Przypadki użycia

Kontrolkę ListView można używać w dowolnej sytuacji, w której są wyświetlane listy danych z możliwością przewijania. Klasa ListView obsługuje akcje kontekstowe i powiązanie danych.

Kontrolka ListView nie powinna być mylona z kontrolką TableView . Kontrolka TableView jest lepszym rozwiązaniem, gdy masz niezwiązaną listę opcji lub danych, ponieważ umożliwia ona określenie wstępnie zdefiniowanych opcji w języku XAML. Na przykład aplikacja ustawień systemu iOS, która ma wstępnie zdefiniowany zestaw opcji, lepiej nadaje się do używania elementu TableViewListViewniż .

Klasa ListView nie obsługuje definiowania elementów listy w języku XAML. Należy użyć ItemsSource właściwości lub powiązania danych z elementem , ItemTemplate aby zdefiniować elementy na liście.

Obiekt ListView najlepiej nadaje się do kolekcji składających się z jednego typu danych. To wymaganie jest spowodowane tym, że dla każdego wiersza na liście może być używany tylko jeden typ komórki. Kontrolka TableView może obsługiwać wiele typów komórek, dlatego jest to lepsza opcja, gdy trzeba wyświetlić wiele typów danych.

Aby uzyskać więcej informacji na temat wiązania danych z wystąpieniem ListView , zobacz ListView data sources (Źródła danych ListView).

Składniki

Kontrolka ListView ma wiele składników dostępnych do wykonywania natywnych funkcji każdej platformy. Te składniki są zdefiniowane w poniższych sekcjach.

Nagłówki i stopki

Składniki nagłówka i stopki są wyświetlane na początku i na końcu listy, niezależnie od danych listy. Nagłówki i stopki można powiązać z oddzielnym źródłem danych od źródła danych elementu ListView.

Grupy

Dane w obiekcie ListView można grupować, aby ułatwić nawigację. Grupy są zwykle powiązane z danymi. Poniższy zrzut ekranu przedstawia element ListView z pogrupowanych danych:

Komórki

Elementy danych w obiekcie ListView są nazywane komórkami. Każda komórka odpowiada wierszowi danych. Istnieją wbudowane komórki do wyboru lub można zdefiniować własną komórkę niestandardową. Zarówno wbudowane, jak i niestandardowe komórki mogą być używane/zdefiniowane w języku XAML lub kodzie.

  • Wbudowane komórki, takie jak TextCell i ImageCell, odpowiadają kontrolkom natywnym i są szczególnie wydajne.
    • Element TextCell wyświetla ciąg tekstu, opcjonalnie z tekstem szczegółowym. Tekst szczegółowy jest renderowany jako drugi wiersz w mniejszej czcionki z kolorem wyróżniającym.
    • Obiekt ImageCell wyświetla obraz z tekstem. Pojawia się jako TextCell element z obrazem po lewej stronie.
  • Komórki niestandardowe służą do prezentowania złożonych danych. Na przykład komórka niestandardowa może służyć do prezentowania listy piosenek zawierających album i artystę.

Poniższy zrzut ekranu przedstawia element ListView z elementami ImageCell:

Aby dowiedzieć się więcej na temat dostosowywania komórek w obiekcie ListView, zobacz Dostosowywanie wyglądu komórki elementu ListView.

Funkcje

Klasa ListView obsługuje wiele stylów interakcji.

  • Funkcja pull-to-refresh umożliwia użytkownikowi ListView ściąganie w dół w celu odświeżenia zawartości.
  • Akcje kontekstowe umożliwiają deweloperowi określanie akcji niestandardowych na poszczególnych elementach listy. Można na przykład zaimplementować akcje szybkiego przesunięcia do akcji w systemie iOS lub akcje z długim naciśnięciem w systemie Android.
  • Zaznaczenie umożliwia deweloperowi dołączanie funkcji do wybierania i usuwania zaznaczenia zdarzeń na elementach listy.

Poniższy zrzut ekranu przedstawia akcje ListView kontekstowe:

Aby dowiedzieć się więcej na temat funkcji interakcyjności programu ListView, zobacz Akcje i interakcyjność za pomocą elementu ListView.