項(xiàng)目中遇到 tab切換列表,每個(gè)tab都需要分頁的需求,分頁流程具有相似性,于是想將分頁封裝為組件,方便應(yīng)用。
組件的應(yīng)用已寫成一個(gè)小demo,效果如下圖所示(數(shù)據(jù)用mock模擬):
源碼可以查看:wxapp-pagination
項(xiàng)目需求
具體項(xiàng)目需求:
當(dāng)然,作為前端,要考慮性能方面的需求:
所以原型圖大概就長這樣:
邏輯實(shí)現(xiàn)
與分頁邏輯相關(guān)的項(xiàng)目結(jié)構(gòu)如下:
├── components│ ├── meeting-item # 列表item│ └── pagination # 分頁組件├── model│ └── user.js # 我的相關(guān) model└── pages│ └── user # 我的相關(guān)頁面│ ├── meetings # 我的會(huì)議(就是tab要分頁的頁面啦)│ └── ...│└── vant-weapp
還是用圖理一下他們之間的關(guān)系吧:
在組件內(nèi)監(jiān)聽觸發(fā)分頁事件
觸發(fā)分頁的事件是滾動(dòng)到頁面的底部,小程序中,觸發(fā)該事件是Page頁面的onReachBottom事件,但是這個(gè)事件只能在Page中觸發(fā),所以要將這個(gè)觸發(fā)時(shí)機(jī)傳遞給pagination組件。
解決思路是:組件 pagination 內(nèi),設(shè)置key屬性,每當(dāng)onReachBottom事件觸發(fā)之后,設(shè)置組件屬性 key 為一個(gè)隨機(jī)字符串,當(dāng)組件 pagination 監(jiān)聽到key的變化的時(shí)候,做出分頁操作。
// components/pagination/index.jsComponent({ properties: { key: { type: String, observer: '_loadMoreData' // _loadMoreData 為分頁操作 } }})
<!-- pages/user/meetings/index.wxml --><tabs active="{{currentTab}}" bind:change="onChange"> <tab <view class="meeting-list"> <pagination name="JOIN" key="{{joinKey}}" > </pagination> </view> </tab> <tab <view class="meeting-list"> <pagination name="BOOK" key="{{bookKey}}" > </pagination> </view> </tab></tabs>
Page({ onReachBottom(){ const key = scene[+this.data.currentTab].key // 對(duì)應(yīng)tab對(duì)應(yīng)key this.setData({ [key]: random(16) }) }})
分頁組件的實(shí)現(xiàn)邏輯
觸發(fā)到達(dá)底部之后,需要加載數(shù)據(jù)。但再加載之前,先滿足加載的條件:
具體加載流程為:
component
// components/pagination/index.jsComponent({ properties: { name: String, key: { type: String, observer: '_loadMoreData' // _loadMoreData 為分頁操作 }, size: { // 每次加載條目數(shù) type: Number, value: 10 }, total: Number, // 頁面總數(shù) list: { // 已加載條目 type: Array, observer: '_endState' // 每次加載完新數(shù)據(jù),判斷數(shù)據(jù)是否全部加載完成 } }, data: { page: 0, // 當(dāng)前第幾頁 loading: false, // 是否正在加載 ended: false // 數(shù)據(jù)是否已全部加載完成 }, methods: { _loadMoreData(){ const { loading, ended, size } = this.data if (loading) return // 上一頁還未加載完成,不加載 if (ended) return // 當(dāng)前頁面全部加載完,不加載 const page = this.data.page + 1 this.setData({ loading: true, // 開始加載新頁面loading設(shè)置為true page }) // 觸發(fā)加載下一頁,并傳入?yún)?shù) this.triggerEvent('getList', { page, size }) }, _endState(val, oldVal) { const { total, list } = this.properties let ended = false // 判斷數(shù)據(jù)是否全部加載完成 if (list.length >= total) { ended = true } this.setData({ loading: false, // 當(dāng)前頁面加載完成,loading設(shè)置為false ended }) } }})
page
<!-- pages/user/meetings/index.wxml --><pagination name="BOOK" key="{{bookKey}}" bind:getList="getBookMeetings" list="{{bookMeetings}}" total="{{bookTotal}}"></pagination>
循環(huán)列表item
pagination組件獲取了可循環(huán)的列表,初始想法是循環(huán)slot,但是在slot中卻獲取不到 item 對(duì)象:
<view wx:for="{{list}}" wx:for-item="item" wx:key="index"> <slot></slot></view>
解決的辦法是將每個(gè)列表項(xiàng)封裝為組件,循環(huán)抽象節(jié)點(diǎn),這樣對(duì)其他頁面的分頁具有可拓展性。
componentGenerics 字段中聲明:
// components/pagination/index.json{ "componentGenerics": { "selectable": true }, // ...}
使用抽象節(jié)點(diǎn):
<!-- components/pagination/index.wxml --><view wx:for="{{list}}" wx:for-item="item" wx:key="index"> <selectable item="{{item}}"></selectable></view>
指定“selectable”具體是哪個(gè)組件:
<!-- pages/user/meetings/index.wxml --><pagination generic:selectable="meeting-item" // ... 其他屬性></pagination>
對(duì)應(yīng) json 文件定義對(duì)應(yīng) usingComponents :
// pages/user/meetings/index.json{ "usingComponents": { "pagination":"/components/pagination/index", "meeting-item":"/components/meeting-item/index" }}
meeting-item 組件接收一個(gè)屬性 item,這樣在 meeting-item 組件中,就可以獲取到循環(huán)列表的item值,并正常繪制頁面。
實(shí)現(xiàn)切換懶加載
給pagination添加initImmediately屬性,當(dāng)initImmediately為true時(shí),首次加載頁面,并用變量 initState標(biāo)記是否已經(jīng)初始化頁面過。
// components/pagination/index.jsComponent({ properties: { initImmediately: { type: Boolean, value: true, observer: function(val){ if (val && !this.data.initState) { this.initData() } } }, // ... }, data: { initState: false, // 是否已經(jīng)加載過 // ... }, lifetimes: { attached: function () { if (this.data.initImmediately){ this.initData() } }, }, methods: { initData(){ console.info(`${this.data.name}:start init data`) this._loadMoreData() this.setData({ initState: true }) }, // ... _endState(val, oldVal) { if (!this.data.initState) return // ... }, }})
當(dāng)currentTab為當(dāng)前類型的時(shí)候,initImmediately 設(shè)置為 true。
<!-- pages/user/meetings/index.wxml --><pagination name="JOIN" init-immediately="{{currentTab==type['JOIN']}}" // ...></pagination><pagination name="BOOK" init-immediately="{{currentTab==type['BOOK']}}" // ...></pagination>
組件的復(fù)用
完成了以上組件,在對(duì)其他分頁的頁面,可以直接復(fù)用。比如,實(shí)現(xiàn)一個(gè)獲取全部用戶列表的分頁,只需要新增一個(gè)user-item的組件,像這樣調(diào)用:
<pagination name="USER" key="{{key}}" bind:getList="getUserList" list="{{userList}}" total="{{userTotal}}" generic:selectable="user-item"></pagination>
具體應(yīng)用可以查看我寫的小demo:wxapp-pagination。
以上就是本文的全部內(nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持VEVB武林網(wǎng)。
新聞熱點(diǎn)
疑難解答
圖片精選