syncfusion-maui-pull-to-refresh

实现 .NET MAUI 下拉刷新（SfPullToRefresh）

Syncfusion .NET MAUI 下拉刷新控件支持通过下拉手势交互式刷新内容。下拉时会显示进度指示器，用户下拉超过阈值距离后松开手指，即会触发内容更新。

何时使用此技能

在以下情况下使用此技能：

• 在 .NET MAUI 应用中实现下拉刷新功能，以便按需刷新内容
• 为可滚动视图添加交互式刷新控件，例如 ListView、DataGrid 或自定义布局
• 显示刷新指示器，在下拉刷新期间提供进度动画
• 自定义刷新外观，包括颜色、大小、过渡模式和阈值
• 创建自定义刷新模板，其中包含进度条或动画视图
• 集成 MVVM 模式，使用刷新命令和数据绑定
• 处理刷新事件，以控制下拉、刷新和完成操作
• 在可下拉的内容区域中承载复杂视图，并确保刷新行为正常

组件概述

• 交互式下拉刷新手势识别
• 两种过渡模式：SlideOnTop 和 Push
• 可自定义进度指示器外观
• 支持将任意 .NET MAUI 视图用作可下拉内容
• 兼容 MVVM，支持 RefreshCommand 和数据绑定
• 可为下拉视图和刷新视图自定义模板
• 内置事件，可精细控制刷新
• 可通过编程方式开始和完成刷新

文档和导航指南

入门

📄 阅读： references/getting-started.md

适合阅读的情况：首次设置、安装和基本实现

• 安装 Syncfusion.Maui.PullToRefresh NuGet 包
• 注册 Syncfusion 处理程序（ConfigureSyncfusionCore）
• 创建基本的 SfPullToRefresh 实例
• 定义 PullableContent
• 处理 IsRefreshing 属性
• 运行首个下拉刷新应用

可下拉内容

📄 阅读： references/pullable-content.md

适合阅读的情况：配置可响应下拉手势的内容

• 了解 PullableContent 属性
• 在 PullToRefresh 中承载 .NET MAUI DataGrid
• 在 PullToRefresh 中承载 .NET MAUI ListView
• 加载自定义视图和布局
• 配置可下拉内容的最佳实践
• 使用不同视图处理内容刷新

自定义和属性

📄 阅读： references/customization.md

适合阅读的情况：自定义外观、行为、阈值和过渡模式

• TransitionMode：SlideOnTop 与 Push 动画
• 配置 PullingThreshold 和 RefreshViewThreshold
• 使用 IsRefreshing 属性控制刷新状态
• 自定义进度指示器（颜色、粗细、大小）
• RefreshViewWidth 和 RefreshViewHeight 属性
• ProgressBackground、ProgressColor、ProgressThickness
• 编程方法：StartRefreshing() 和 EndRefreshing()
• 大小和布局注意事项

自定义模板

📄 阅读： references/templates.md

适合阅读的情况：创建自定义下拉视图和刷新视图

• PullingViewTemplate 属性
• RefreshingViewTemplate 属性
• 在模板中使用 SfCircularProgressBar
• 为自定义进度指示器创建 DataTemplate
• 将模板与 Pulling 事件集成
• 为刷新视图添加动画
• 模板自定义示例

MVVM 和命令

📄 阅读： references/mvvm-commands.md

适合阅读的情况：使用 PullToRefresh 实现 MVVM 模式

• MVVM 兼容性概述
• 将 IsRefreshing 绑定到 ViewModel 属性
• 使用 RefreshCommand 和 RefreshCommandParameter
• 使用 CanExecute() 方法控制刷新操作
• 实现 INotifyPropertyChanged
• 完整的 ViewModel 示例
• 从 ViewModel 取消下拉操作

事件

📄 阅读： references/events.md

阅读时机：处理下拉刷新生命周期事件

• 使用 PullingEventArgs 的 Pulling 事件
• 释放指针时触发的 Refreshing 事件
• 完成时触发的 Refreshed 事件
• 用于阻止刷新的 Cancel 属性
• 用于跟踪下拉距离的 Progress 属性
• 事件处理模式和示例