一、前言 下拉刷新和上拉載入這兩種交互方式通常出現在移動端中 本質上等同於PC網頁中的分頁,只是交互形式不同 開源社區也有很多優秀的解決方案,如iscroll、better-scroll、pulltorefresh.js庫等等 這些第三方庫使用起來非常便捷 我們通過原生的方式實現一次上拉載入,下拉刷 ...
一、前言
下拉刷新和上拉載入這兩種交互方式通常出現在移動端中
本質上等同於PC網頁中的分頁,只是交互形式不同
開源社區也有很多優秀的解決方案,如iscroll
、better-scroll
、pulltorefresh.js
庫等等
這些第三方庫使用起來非常便捷
我們通過原生的方式實現一次上拉載入,下拉刷新,有助於對第三方庫有更好的理解與使用
二、實現原理
上拉載入及下拉刷新都依賴於用戶交互
最重要的是要理解在什麼場景,什麼時機下觸發交互動作
上拉載入
首先可以看一張圖
上拉載入的本質是頁面觸底,或者快要觸底時的動作
判斷頁面觸底我們需要先瞭解一下下麵幾個屬性
-
scrollTop
:滾動視窗的高度距離window
頂部的距離,它會隨著往上滾動而不斷增加,初始值是0,它是一個變化的值 -
clientHeight
:它是一個定值,表示屏幕可視區域的高度; -
scrollHeight
:頁面不能滾動時也是存在的,此時scrollHeight等於clientHeight。scrollHeight表示body
所有元素的總長度(包括body元素自身的padding)
綜上我們得出一個觸底公式:
scrollTop + clientHeight >= scrollHeight
簡單實現
let clientHeight = document.documentElement.clientHeight; //瀏覽器高度 let scrollHeight = document.body.scrollHeight; let scrollTop = document.documentElement.scrollTop; let distance = 50; //距離視窗還用50的時候,開始觸發; if ((scrollTop + clientHeight) >= (scrollHeight - distance)) { console.log("開始載入數據"); }
下拉刷新
下拉刷新的本質是頁面本身置於頂部時,用戶下拉時需要觸發的動作
關於下拉刷新的原生實現,主要分成三步:
- 監聽原生
touchstart
事件,記錄其初始位置的值,e.touches[0].pageY
; - 監聽原生
touchmove
事件,記錄並計算當前滑動的位置值與初始位置值的差值,大於0
表示向下拉動,並藉助CSS3的translateY
屬性使元素跟隨手勢向下滑動對應的差值,同時也應設置一個允許滑動的最大值; - 監聽原生
touchend
事件,若此時元素滑動達到最大值,則觸發callback
,同時將translateY
重設為0
,元素回到初始位置
舉個例子:
Html
結構如下:
<main> <p class="refreshText"></p > <ul id="refreshContainer"> <li>111</li> <li>222</li> <li>333</li> <li>444</li> <li>555</li> ... </ul> </main>
監聽touchstart
事件,記錄初始的值
var _element = document.getElementById('refreshContainer'), _refreshText = document.querySelector('.refreshText'), _startPos = 0, // 初始的值 _transitionHeight = 0; // 移動的距離 _element.addEventListener('touchstart', function(e) { _startPos = e.touches[0].pageY; // 記錄初始位置 _element.style.position = 'relative'; _element.style.transition = 'transform 0s'; }, false);
監聽touchmove
移動事件,記錄滑動差值
_element.addEventListener('touchmove', function(e) { // e.touches[0].pageY 當前位置 _transitionHeight = e.touches[0].pageY - _startPos; // 記錄差值 if (_transitionHeight > 0 && _transitionHeight < 60) { _refreshText.innerText = '下拉刷新'; _element.style.transform = 'translateY('+_transitionHeight+'px)'; if (_transitionHeight > 55) { _refreshText.innerText = '釋放更新'; } } }, false);
最後,就是監聽touchend
離開的事件
_element.addEventListener('touchend', function(e) { _element.style.transition = 'transform 0.5s ease 1s'; _element.style.transform = 'translateY(0px)'; _refreshText.innerText = '更新中...'; // todo... }, false);
從上面可以看到,在下拉到鬆手的過程中,經歷了三個階段:
- 當前手勢滑動位置與初始位置差值大於零時,提示正在進行下拉刷新操作
- 下拉到一定值時,顯示鬆手釋放後的操作提示
- 下拉到達設定最大值鬆手時,執行回調,提示正在進行更新操作
三、案例
在實際開發中,我們更多的是使用第三方庫,下麵以better-scroll
進行舉例:
HTML結構
<div id="position-wrapper"> <div> <p class="refresh">下拉刷新</p > <div class="position-list"> <!--列表內容--> </div> <p class="more">查看更多</p > </div> </div>
實例化上拉下拉插件,通過use
來註冊插件
import BScroll from "@better-scroll/core"; import PullDown from "@better-scroll/pull-down"; import PullUp from '@better-scroll/pull-up'; BScroll.use(PullDown); BScroll.use(PullUp);
實例化BetterScroll
,並傳入相關的參數
let pageNo = 1,pageSize = 10,dataList = [],isMore = true; var scroll= new BScroll("#position-wrapper",{ scrollY:true,//垂直方向滾動 click:true,//預設會阻止瀏覽器的原生click事件,如果需要點擊,這裡要設為true pullUpLoad:true,//上拉載入更多 pullDownRefresh:{ threshold:50,//觸發pullingDown事件的位置 stop:0//下拉回彈後停留的位置 } }); //監聽下拉刷新 scroll.on("pullingDown",pullingDownHandler); //監測實時滾動 scroll.on("scroll",scrollHandler); //上拉載入更多 scroll.on("pullingUp",pullingUpHandler); async function pullingDownHandler(){ dataList=[]; pageNo=1; isMore=true; $(".more").text("查看更多"); await getlist();//請求數據 scroll.finishPullDown();//每次下拉結束後,需要執行這個操作 scroll.refresh();//當滾動區域的dom結構有變化時,需要執行這個操作 } async function pullingUpHandler(){ if(!isMore){ $(".more").text("沒有更多數據了"); scroll.finishPullUp();//每次上拉結束後,需要執行這個操作 return; } pageNo++; await this.getlist();//請求數據 scroll.finishPullUp();//每次上拉結束後,需要執行這個操作 scroll.refresh();//當滾動區域的dom結構有變化時,需要執行這個操作 } function scrollHandler(){ if(this.y>50) $('.refresh').text("鬆手開始載入"); else $('.refresh').text("下拉刷新"); } function getlist(){ //返回的數據 let result=....; dataList=dataList.concat(result); //判斷是否已載入完 if(result.length<pageSize) isMore=false; //將dataList渲染到html內容中 }
註意點:
使用better-scroll
實現下拉刷新、上拉載入時要註意以下幾點:
wrapper
里必須只有一個子元素- 子元素的高度要比
wrapper
要高 - 使用的時候,要確定
DOM
元素是否已經生成,必須要等到DOM
渲染完成後,再new BScroll()
- 滾動區域的
DOM
元素結構有變化後,需要執行刷新refresh()
- 上拉或者下拉,結束後,需要執行
finishPullUp()
或者finishPullDown()
,否則將不會執行下次操作 better-scroll
,預設會阻止瀏覽器的原生click
事件,如果滾動內容區要添加點擊事件,需要在實例化屬性里設置click:true
小結
下拉刷新、上拉載入原理本身都很簡單,真正複雜的是封裝過程中,要考慮的相容性、易用性、性能等諸多細節
參考文獻
- https://segmentfault.com/a/1190000014423308
- https://github.com/ustbhuangyi/better-scroll
如果對您有所幫助,歡迎您點個關註,我會定時更新技術文檔,大家一起討論學習,一起進步。