如何實現上拉載入，下拉重新整理？

林恒發表於2024-05-22

一、前言

下拉重新整理和上拉載入這兩種互動方式通常出現在移動端中

本質上等同於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

如果對您有所幫助，歡迎您點個關注，我會定時更新技術文件，大家一起討論學習，一起進步。

如何實現上拉載入，下拉重新整理？

相關文章