今日頭條小程序ttstartpulldownrefresh-badge-text100mapcontext
小編:啊南 20閱讀 2020.12.16
tt.startPullDownRefresh 1.0.0+
回調成功
回調失敗
基礎庫 1.0.0 開始支持。
下拉刷新,小程序會主動觸發下拉刷新動畫,直到調用 tt.stopPullDownRefresh 成功后停止,調用該方法與用戶手動觸發下拉刷新效果一致。
語法tt.startPullDownRefresh([options])參數說明
options為 object 類型,屬性如下:
屬性名 | 類型 | 默認值 | 必填 | 說明 | 最低支持版本 |
---|---|---|---|---|---|
success | function | 否 | 接口調用成功的回調函數 | 1.0.0 | |
fail | function | 否 | 接口調用失敗的回調函數 | 1.0.0 | |
complete | function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) | 1.0.0 |
Object 類型,屬性如下:
屬性 | 類型 | 說明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "startPullDownRefresh:ok" | 1.0.0 |
Object 類型,屬性如下:
屬性 | 類型 | 說明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "startPullDownRefresh:fail "+詳細錯誤信息 | 1.0.0 |
請使用字節宿主APP掃碼
開發者工具中預覽
【代碼示例 1】:無參數示例
預期表現:正常觸發/停止頁面刷新。
<!-- index.ttml --><button bindtap="startPullDownRefresh">點擊觸發頁面下拉刷新(無參)</button><button bindtap="stopPullDownRefresh">點擊停止頁面下拉刷新(無參)</button>
// index.jsPage({ startPullDownRefresh() { tt.startPullDownRefresh(); }, stopPullDownRefresh() { tt.stopPullDownRefresh(); },});
// index.json{ "enablePullDownRefresh": true}
【代碼示例 2】:有參數示例
預期表現:正常觸發/停止頁面刷新,并給出成功或失敗提示。
<!-- index.ttml --><button bindtap="startPullDownRefresh">點擊觸發頁面下拉刷新</button><button bindtap="stopPullDownRefresh">點擊停止頁面下拉刷新</button>
// index.jsPage({ 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才能夠開啟下拉刷新,可參考代碼示例。
-
Tip:直到調用 tt.stopPullDownRefresh 成功后才會停止刷新,否則一直刷新。
相關推薦
- 今日頭條小程序接入流程指引 接入流程指引以字節小程序為載體,開發者可利用小程序提供的豐富基礎能力完成服務搭建,在字節跳動各個 App 精準匹配用戶需求,為全球 15 億用戶提供優質服務的同時,也讓自身業務完成流量與轉化升級。注意:創建小程序前請了解 小程序限制類目及所需資質材料,…
- 原生JS與jQuery對AJAX的實現 一、定義W3C里這么解釋AJAX:AJAX = Asynchronous JavaScript and XML(異步的 JavaScript 和 XML)。AJAX 不是新的編程語言,而是一種使用現有標準的新方法。AJAX 是與服務器交換數據并更新部分網頁的藝術,在不重新加載整個頁面的情況下。就是利用JS來無刷新…