tt.stopPullDownRefresh 1.0.0+
停止当前页面下拉刷新。相关接口:tt.startPullDownRefresh。
语法
tt.stopPullDownRefresh([options])
参数说明
options
为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | 1.0.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 1.0.0 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行),回调参数同成功或失败回调 | 1.0.0 |
回调成功
Object 类型,属性如下:
属性 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "stopPullDownRefresh:ok" | 1.0.0 |
回调失败
Object 类型,属性如下:
属性 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "stopPullDownRefresh:fail "+详细错误信息 | 1.0.0 |
效果示例

扫码体验
请使用字节宿主APP扫码
代码示例
【代码示例 1】:无参数示例
预期表现:正常触发 / 停止下拉刷新。
<!-- index.ttml -->
<button bindtap="startPullDownRefresh">点击触发页面下拉刷新(无参)</button>
<button bindtap="stopPullDownRefresh">点击停止页面下拉刷新(无参)</button>
// index.js
Page({
startPullDownRefresh() {
tt.startPullDownRefresh();
},
stopPullDownRefresh() {
tt.stopPullDownRefresh();
},
});
// index.json
{
"enablePullDownRefresh": true
}
【代码示例 2】:有参数示例
预期表现:正常触发 / 停止下拉刷新,并给出成功或失败提示。
<!-- index.ttml -->
<button bindtap="startPullDownRefresh">点击触发页面下拉刷新</button>
<button bindtap="stopPullDownRefresh">点击停止页面下拉刷新</button>
// index.js
Page({
startPullDownRefresh() {
tt.startPullDownRefresh({
success: function (res) {
tt.showToast({ title: "页面开始刷新" });
},
fail: function (err) {
tt.showModal({
title: "页面刷新失败",
content: err.errMsg,
showCancel: false,
});
},
complete: function (res) {
console.log(`stopPullDownRefresh调用完成`);
},
});
},
stopPullDownRefresh() {
tt.stopPullDownRefresh({
success: function (res) {
tt.showToast({ title: "页面停止刷新" });
},
fail: function (err) {
tt.showModal({
title: "停止刷新失败",
content: err.errMsg,
showCancel: false,
});
},
complete: function (res) {
console.log(`stopPullDownRefresh调用完成`);
},
});
},
});
// index.json
{
"enablePullDownRefresh": true
}
Bug & Tip
- Tip:只有在页面的
page.json
中配置了enablePullDownRefresh: true
才能够开启下拉刷新,具体请参考代码示例。
点击纠错
评价此篇文档