全部产品

onPullDownRefresh

在 Page 中自定义 onPullDownRefresh 函数,可以监听该页面用户的下拉刷新事件。

  • 在页面对应的 .json 配置文件中配置 "pullRefresh": true 选项,方可开启下拉刷新事件。
  • 数据刷新处理完毕,调用 my.stopPullDownRefresh 可停止当前页面的下拉刷新。

注意:window 中 pullRefreshallowsBounceVertical 属性的设置会影响下拉刷新的使用。

示例代码

// API-DEMO page/API/pull-down-refresh/pull-down-refresh.json
{
    "defaultTitle": "下拉刷新",
    "pullRefresh": true
}

<!-- API-DEMO page/API/pull-down-refresh/pull-down-refresh.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-title">下滑页面即可刷新</view>
    <view class="page-section-btns">
      <view type="primary" onTap="stopPullDownRefresh">停止刷新</view>
    </view>
  </view>
</view>undefined

// API-DEMO page/API/pull-down-refresh/pull-down-refresh.js
Page({
  onPullDownRefresh() {
    console.log('onPullDownRefresh', new Date());
  },
  stopPullDownRefresh() {
    my.stopPullDownRefresh({
      complete(res) {
        console.log(res, new Date())
      }
    })
  }
});undefined

入参

属性类型必填描述
pullRefreshBoolean

是否允许下拉刷新。默认 true。

说明:下拉刷新生效的前提是allowsBounceVertical 值为 YES

allowsBounceVerticalString页面是否支持纵向拽拉超出实际内容。默认 YES,支持 YES/NO