Xamarin.Forms Views介绍（六）——ListView

tslids

于 2021-01-23 10:27:00 发布

阅读量849

点赞数

分类专栏： Android

本文链接：https://blog.csdn.net/tsliuch/article/details/112704460

版权

Android 专栏收录该内容

74 篇文章 1 订阅

订阅专栏

以下主要内容转自：http://www.jianshu.com/p/55c8e3e672ec

ListView属性

Footer ：object类型，获取、设置列表底部的字符串或视图。

FooterTemplate ：DataTemplate类型，获取、设置列表底部数据模版。

Header ：object类型，获取、设置列表顶部的字符串或视图。

HeaderTemplate ：DataTemplate类型，获取、设置列表定部数据模版。

HasUnevenRows ：bool类型，表示列表是否有不均匀的行高，默认值false，设置为true后ListView每行的高度会因为内容不同而提供不同高度。

可以在运行时通过Cell.ForceUpdateSize 方法更新cell大小。

IsGroupingEnabled ：bool类型，表示是否对列表进行分组。

GroupDisplayBinding : 绑定分组头的值。

GroupHeaderTemplate : DataTemplate类型，分组头的数据模版。

GroupShortNameBinding : 绑定分组跳转列表中的值。

IsPullToRefreshEnabled ：bool类型，表示列表是否可以进行下拉刷新。

IsRefreshing ：bool类型，表示列表是否正在刷新。

RowHeight ：表示列表行高。

SelectedItem ：object类型，表示列表当前选中对象。

SeparatorColor ：表示列表分割栏的颜色。

SeparatorVisibility ：SeparatorVisibility枚举，表示分割栏的显示方式。

ListView事件

ItemAppearing ：ListView元素显示时触发，ListView滑动使Item显示在屏幕内。

ItemDisappearing ：ListView元素消失时触发，ListView滑动使Item消失在屏幕内。

ItemSelected ：新的Item元素被选中时触发。

ItemTapped ：ListView的元素Item被点击是触发。

Refreshing ：ListView刷新事件。

ListView基本使用

填充ListView显示的数据有两种方式：设置ListView的ItemsSource和Data Binding。Data Binding后面介绍。ItemsSource类型是IEnumerable。

XAML定义ListView会默认填充整个屏幕

  <ListView x:Name="listView"/>

通过C#代码设置ItemsSource：

    listView.ItemsSource = new List<string>() {"List Item 1","List Item 2","List Item 3","List Item 4","List Item 5"};

IOS会有多余分割线显示可以通过代码隐藏分割线listView.SeparatorVisibility = SeparatorVisibility.None;

默认情况下ItemSource集合提供的数据调用ToString方法显示在TextCell上，即 ListView每行是一个TextCell。

ListView 结合 Data Binding使用

ListView的数据源（ItemsSource）不仅可以是简单的字符串集合也可以是自定义的Model类集合，要显示类集合数据时需要结合Data Binding实现，演示一个TextCell显示Text和Detail的示例。

新建ListViewItem类：

    class ListViewItem
    {
        public string Title { get; set; }
        public string Detail { get; set; }

    }

Data Source设置代码：

            var source = new List<ListViewItem>()
            {
                new ListViewItem {Title="Title1",Detail="Detail1" },
                new ListViewItem {Title="Title2",Detail="Detail2" },
                new ListViewItem {Title="Title3",Detail="Detail3" },
                new ListViewItem {Title="Title4",Detail="Detail4" },
                new ListViewItem {Title="Title5",Detail="Detail5" }
            };

            listView.ItemsSource = source;

在定义ItemSource的数据集合时推荐用ObservableCollection<T>代替List<T>,ObservableCollection实现了INotifyPropertyChanged接口能够通知数据的变化，提供更新功能。

在XAML代码中定义ListVIew时应显示指出TextCell的展现形式。设置ListView.ItemTemplate,DataTemplate元素节点内定义一个TextCell，绑定 TextCell的Text和Detail属性为对应Model的属性。

  <ListView x:Name="listView">
      <ListView.ItemTemplate>
          <DataTemplate>
              <TextCell Text="{Binding Title}" Detail="{Binding Detail}"/>
          </DataTemplate>
      </ListView.ItemTemplate>

  </ListView>

运行效果：

ListView Selected事件

当用户点击ListView的Item时触发ListView的ItemTapped事件，SelectedItem值发生改变还会触发ItemSelected事件，用户连续点击同一个Item时ItemTapped触发多次，SelectedItem只会在第一次点击时触发。

如果想使ListView禁用ListView被取消ListView的选中效果

            listView.ItemSelected += (sender, e) => {
                listView.SelectedItem = null;

            };

ListView Cell介绍

前面有提到过TextCell，是Xamarin.Forms 提供的Cell子类可以帮助我们显示更复杂的ListView。

Xamarin.Forms提供给ListVIew常用的Cell有两种：TextCell和ImageCell。SwitchCell和EntryCell通常用在TableView中。

TextCell 用来显示文本，并允许在第二行显示详细文本：

Text – 显示在第一行的文本，以较大字体显示.

Detail – 以较小字体显示在第二行的文本.

TextColor – Text文本颜色.

DetailColor – Detail文本颜色.

ImageCell与TextCell相比在Cell的左侧可以显示图片信息。

具体使用参考ListView 结合 Data Binding使用。更复杂的列表效果需自定义单元格，继承ViewCell实现期望的效果。自定义单元格更多信息参考：https://developer.xamarin.com/guides/xamarin-forms/user-interface/listview/customizing-cell-appearance/#Custom_Cells