syncfusion-maui-toolkit-pull-to-refresh

实现 .NET MAUI PullToRefresh（SfPullToRefresh）

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

何时使用此技能

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

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

组件概览

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

文档和导航指南

入门

📄 阅读： references/getting-started.md

阅读时机：首次设置、安装和基本实现

• 安装 Syncfusion.Maui.Toolkit NuGet 包
• 注册 Syncfusion 处理程序（ConfigureSyncfusionToolkit）
• 创建基本的 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 属性
• 事件处理模式和示例