SxPullToRefresh (下拉刷新)

  • Implemented

移动端常用的下拉刷新容器。对齐 Microsoft Fluent UI Blazor PullToRefresh (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。

使用场景

  • 列表下拉刷新
  • 移动端内容更新
  • 数据同步提示

约束说明

  • 仅响应触摸事件。
  • Threshold 控制触发距离。

行为说明

  • 拉动距离超过阈值触发 OnRefresh。
  • Refreshing 为真时显示加载动画。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented ChildContent RenderFragment? null 内容区域。
Implemented Refreshing bool false 刷新状态。
Implemented Threshold int 60 触发阈值。
Implemented Disabled (继承) bool false 禁用状态。
Implemented Id (继承) string? null 组件 Id。
Implemented Class (继承) string? null CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title。
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 额外属性。

Events (事件)

状态 事件名 类型 描述
Implemented OnRefresh EventCallback 触发刷新动作时回调。

示例

<SxPullToRefresh OnRefresh="@OnRefreshAsync">
    <div>下拉刷新内容</div>
</SxPullToRefresh>

参考设计 (References)

在 Playground 中打开 →