下拉刷新

onPullDownRefresh

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

• 需要在 app.json 的 window 选项中配置 "allowsBounceVertical":"YES"，在页面对应的 .json 配置文件中配置 "pullRefresh":true 选项，才可开启页面下拉刷新事件。
• 调用 my.startPullDownRefresh 后触发下拉刷新动画，效果与用户手动下拉刷新一致（会触发 onPullDownRefresh 监听方法）。
• 当处理完数据刷新后，my.stopPullDownRefresh 可停止当前页面的下拉刷新。

入参

代码示例

// 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>

// 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())
      }
    })
  }
});

my.stopPullDownRefresh

停止当前页面的下拉刷新。

• 调用 my.startPullDownRefresh 后触发下拉刷新动画，效果与用户手动下拉刷新一致（会触发 onPullDownRefresh 监听方法）。
• 当处理完数据刷新后，my.stopPullDownRefresh 可停止当前页面的下拉刷新。

入参

Object 类型，属性如下：

代码示例

// 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>

// 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())
      }
    })
  }
});

my.startPullDownRefresh

开始下拉刷新。

• 调用 my.startPullDownRefresh 后触发下拉刷新动画，效果与用户手动下拉刷新一致（会触发 onPullDownRefresh 监听方法）。
• 当处理完数据刷新后，my.stopPullDownRefresh 可停止当前页面的下拉刷新。
• my.startPullDownRefresh 不受 allowsBounceVertical 、pullRefresh 参数影响。

入参

Object 类型，属性如下：

代码示例

my.startPullDownRefresh()