Xamarin.Forms RefreshView

RefreshView 是一个容器控件，为可滚动内容提供拉取刷新功能。 因此，RefreshView 的子级必须是可滚动控件，例如 ScrollView、CollectionView 或 ListView。

RefreshView 定义以下属性：

• Command，类型为 ICommand，在触发刷新时执行。
• CommandParameter 属于 object 类型，是传递给 Command 的参数。
• IsRefreshing，类型为 bool，指示 RefreshView 的当前状态。
• RefreshColor，类型为 Color，刷新期间显示的进度圆的颜色。

这些属性由 BindableProperty 对象提供支持，表示它们可以是数据绑定的目标，并可以设置样式。

创建 RefreshView

以下示例演示如何在 XAML 中实例化 RefreshView：

<RefreshView IsRefreshing="{Binding IsRefreshing}"
             Command="{Binding RefreshCommand}">
    <ScrollView>
        <FlexLayout Direction="Row"
                    Wrap="Wrap"
                    AlignItems="Center"
                    AlignContent="Center"
                    BindableLayout.ItemsSource="{Binding Items}"
                    BindableLayout.ItemTemplate="{StaticResource ColorItemTemplate}" />
    </ScrollView>
</RefreshView>

还可以在代码中创建 RefreshView：

RefreshView refreshView = new RefreshView();
ICommand refreshCommand = new Command(() =>
{
    // IsRefreshing is true
    // Refresh data here
    refreshView.IsRefreshing = false;
});
refreshView.Command = refreshCommand;

ScrollView scrollView = new ScrollView();
FlexLayout flexLayout = new FlexLayout { ... };
scrollView.Content = flexLayout;
refreshView.Content = scrollView;

在此示例中，RefreshView 为子级为 FlexLayout 的 ScrollView 提供拉取刷新功能。 FlexLayout 使用可绑定布局通过绑定到项集合来生成其内容，并使用 DataTemplate 设置每个项的外观。 有关可绑定布局的详细信息，请参阅 Xamarin.Forms 中的可绑定布局。

RefreshView.IsRefreshing 属性的值指示 RefreshView 的当前状态。 当用户触发刷新时，此属性将自动转换为 true。 刷新完成后，应将属性重置为 false。

当用户启动刷新时，将执行由 Command 属性定义的 ICommand，这将刷新所显示的项。 刷新时会显示刷新可视化效果，其中包含动画形式的圆形进度：

RefreshView 外观

除了 RefreshView 从 VisualElement 类继承的属性外，RefreshView 还定义 RefreshColor 属性。 可以将此属性设置为定义刷新期间显示的进度圆的颜色：

<RefreshView RefreshColor="Teal"
             ... />

以下屏幕截图显示设置了 RefreshColor 属性的 RefreshView：

此外，还可以将 BackgroundColor 属性设置为表示进度圆背景色的 Color。

禁用 RefreshView

应用程序可能进入拉取刷新是无效操作的状态。 在这种情况下，可以通过将 RefreshView 的 IsEnabled 属性设置为 false 来对其进行禁用。 这会阻止用户触发拉取刷新。

或者，在定义 Command 属性时，可以指定 ICommand 的 CanExecute 委托来启用或禁用该命令。

相关链接

• Xamarin.Forms 中的可绑定布局
• RefreshView 拉取方向平台特定功能