# uni.startPullDownRefresh(options?)

开始下拉刷新

# startPullDownRefresh 兼容性

Web Android iOS
4.0 3.91 4.11

# 参数

名称 类型 必填 默认值 兼容性 描述
options StartPullDownRefreshOptions - -
名称 类型 必备 默认值 兼容性 描述
success (result: AsyncApiSuccessResult) => void - - 接口调用成功的回调函数
fail (result: StartPullDownRefreshFail) => void - - 接口调用失败的回调函数
complete (result: AsyncApiResult) => void - - 接口调用结束的回调函数(调用成功、失败都会执行)

# StartPullDownRefreshFail 的属性值

名称 类型 必备 默认值 兼容性 描述
errCode number - - 下拉刷新错误码
- 4: 框架内部异常
errSubject string - - 统一错误主题(模块)名称
data any - - 错误信息中包含的数据
cause Error - - 源错误信息,可以包含多个错误,详见SourceError
errMsg string - - -

# AsyncApiResult 的属性值

名称 类型 必备 默认值 兼容性 描述
errMsg string - - -

# 返回值

类型 必备
Promise<AsyncApiSuccessResult>
名称 类型 必备 默认值 兼容性 描述
errMsg string - - -

# 参见

# uni.stopPullDownRefresh()

停止当前页面下拉刷新

# stopPullDownRefresh 兼容性

Web Android iOS
4.0 3.91 4.11

使用:

  1. 首先pages.json里配置了页面可下拉刷新"enablePullDownRefresh": true
  2. 当用户下拉页面时触发页面生命周期onPullDownRefresh
  3. 在合适的时机(如联网刷新数据结束),调用本APIuni.stopPullDownRefresh(),结束下拉刷新状态

本API仅负责页面下拉刷新。如使用组件下拉刷新,另见scroll-view、list-view等组件的文档。

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string - - 错误信息