如何实现上拉加载，下拉刷新？ - 图1

一、前言

下拉刷新和上拉加载这两种交互方式通常出现在移动端中

本质上等同于PC网页中的分页，只是交互形式不同

开源社区也有很多优秀的解决方案，如iscroll、better-scroll、pulltorefresh.js库等等

这些第三方库使用起来非常便捷

我们通过原生的方式实现一次上拉加载，下拉刷新，有助于对第三方库有更好的理解与使用

二、实现原理

上拉加载及下拉刷新都依赖于用户交互

最重要的是要理解在什么场景，什么时机下触发交互动作

上拉加载

首先可以看一张图

如何实现上拉加载，下拉刷新？ - 图2

上拉加载的本质是页面触底，或者快要触底时的动作

判断页面触底我们需要先了解一下下面几个属性

  • scrollTop：滚动视窗的高度距离window顶部的距离，它会随着往上滚动而不断增加，初始值是0，它是一个变化的值
  • clientHeight:它是一个定值，表示屏幕可视区域的高度；
  • scrollHeight：页面不能滚动时也是存在的,此时scrollHeight等于clientHeight。scrollHeight表示body所有元素的总长度(包括body元素自身的padding)

综上我们得出一个触底公式：

  1. scrollTop + clientHeight >= scrollHeight

简单实现

  1. let clientHeight  = document.documentElement.clientHeight; //浏览器高度
  2. let scrollHeight = document.body.scrollHeight;
  3. let scrollTop = document.documentElement.scrollTop;
  5. let distance = 50;  //距离视窗还用50的时候，开始触发；
  7. if ((scrollTop + clientHeight) >= (scrollHeight - distance)) {
  8.     console.log("开始加载数据");
  9. }

下拉刷新

下拉刷新的本质是页面本身置于顶部时，用户下拉时需要触发的动作

关于下拉刷新的原生实现，主要分成三步：

  • 监听原生touchstart事件，记录其初始位置的值，e.touches[0].pageY；
  • 监听原生touchmove事件，记录并计算当前滑动的位置值与初始位置值的差值，大于0表示向下拉动，并借助CSS3的translateY属性使元素跟随手势向下滑动对应的差值，同时也应设置一个允许滑动的最大值；
  • 监听原生touchend事件，若此时元素滑动达到最大值，则触发callback，同时将translateY重设为0，元素回到初始位置

举个例子：

Html结构如下：

  1. <main>
  2.     <p class="refreshText"></p >
  3.     <ul id="refreshContainer">
  4.         <li>111</li>
  5.         <li>222</li>
  6.         <li>333</li>
  7.         <li>444</li>
  8.         <li>555</li>
  9.         ...
  10.     </ul>
  11. </main>

监听touchstart事件，记录初始的值

  1. var _element = document.getElementById('refreshContainer'),
  2.     _refreshText = document.querySelector('.refreshText'),
  3.     _startPos = 0,  // 初始的值
  4.     _transitionHeight = 0; // 移动的距离
  6. _element.addEventListener('touchstart', function(e) {
  7.     _startPos = e.touches[0].pageY; // 记录初始位置
  8.     _element.style.position = 'relative';
  9.     _element.style.transition = 'transform 0s';
  10. }, false);

监听touchmove移动事件，记录滑动差值

  1. _element.addEventListener('touchmove', function(e) {
  2.     // e.touches[0].pageY 当前位置
  3.     _transitionHeight = e.touches[0].pageY - _startPos; // 记录差值
  5.     if (_transitionHeight > 0 && _transitionHeight < 60) { 
  6.         _refreshText.innerText = '下拉刷新'; 
  7.         _element.style.transform = 'translateY('+_transitionHeight+'px)';
  9.         if (_transitionHeight > 55) {
  10.             _refreshText.innerText = '释放更新';
  11.         }
  12.     }                
  13. }, false);

最后，就是监听touchend离开的事件

  1. _element.addEventListener('touchend', function(e) {
  2.     _element.style.transition = 'transform 0.5s ease 1s';
  3.     _element.style.transform = 'translateY(0px)';
  4.     _refreshText.innerText = '更新中...';
  5.     // todo...
  7. }, false);

从上面可以看到，在下拉到松手的过程中，经历了三个阶段：

  • 当前手势滑动位置与初始位置差值大于零时，提示正在进行下拉刷新操作
  • 下拉到一定值时，显示松手释放后的操作提示
  • 下拉到达设定最大值松手时，执行回调，提示正在进行更新操作

三、案例

在实际开发中，我们更多的是使用第三方库，下面以better-scroll进行举例：

HTML结构

  1. <div id="position-wrapper">
  2.     <div>
  3.         <p class="refresh">下拉刷新</p >
  4.         <div class="position-list">
  5.    <!--列表内容-->
  6.         </div>
  7.         <p class="more">查看更多</p >
  8.     </div>
  9. </div>

实例化上拉下拉插件，通过use来注册插件

  1. import BScroll from "@better-scroll/core";
  2. import PullDown from "@better-scroll/pull-down";
  3. import PullUp from '@better-scroll/pull-up';
  4. BScroll.use(PullDown);
  5. BScroll.use(PullUp);

实例化BetterScroll，并传入相关的参数

  1. let pageNo = 1,pageSize = 10,dataList = [],isMore = true;  
  2. var scroll= new BScroll("#position-wrapper",{
  3.     scrollY:true,//垂直方向滚动
  4.     click:true,//默认会阻止浏览器的原生click事件，如果需要点击，这里要设为true
  5.     pullUpLoad:true,//上拉加载更多
  6.     pullDownRefresh:{
  7.         threshold:50,//触发pullingDown事件的位置
  8.         stop:0//下拉回弹后停留的位置
  9.     }
  10. });
  11. //监听下拉刷新
  12. scroll.on("pullingDown",pullingDownHandler);
  13. //监测实时滚动
  14. scroll.on("scroll",scrollHandler);
  15. //上拉加载更多
  16. scroll.on("pullingUp",pullingUpHandler);
  18. async function pullingDownHandler(){
  19.     dataList=[];
  20.     pageNo=1;
  21.     isMore=true;
  22.     $(".more").text("查看更多");
  23.     await getlist();//请求数据
  24.     scroll.finishPullDown();//每次下拉结束后，需要执行这个操作
  25.     scroll.refresh();//当滚动区域的dom结构有变化时，需要执行这个操作
  26. }
  27. async function pullingUpHandler(){
  28.     if(!isMore){
  29.         $(".more").text("没有更多数据了");
  30.         scroll.finishPullUp();//每次上拉结束后，需要执行这个操作
  31.         return;
  32.     }
  33.     pageNo++;
  34.     await this.getlist();//请求数据
  35.     scroll.finishPullUp();//每次上拉结束后，需要执行这个操作
  36.     scroll.refresh();//当滚动区域的dom结构有变化时，需要执行这个操作    
  37. }
  38. function scrollHandler(){
  39.     if(this.y>50) $('.refresh').text("松手开始加载");
  40.     else $('.refresh').text("下拉刷新");
  41. }
  42. function getlist(){
  43.     //返回的数据
  44.     let result=....;
  45.     dataList=dataList.concat(result);
  46.     //判断是否已加载完
  47.     if(result.length<pageSize) isMore=false;
  48.     //将dataList渲染到html内容中
  49. }

注意点：

使用better-scroll实现下拉刷新、上拉加载时要注意以下几点：

  • wrapper里必须只有一个子元素
  • 子元素的高度要比wrapper要高
  • 使用的时候，要确定DOM元素是否已经生成，必须要等到DOM渲染完成后，再new BScroll()
  • 滚动区域的DOM元素结构有变化后，需要执行刷新 refresh()
  • 上拉或者下拉，结束后，需要执行finishPullUp()或者finishPullDown()，否则将不会执行下次操作
  • better-scroll，默认会阻止浏览器的原生click事件，如果滚动内容区要添加点击事件，需要在实例化属性里设置click:true

小结

下拉刷新、上拉加载原理本身都很简单，真正复杂的是封装过程中，要考虑的兼容性、易用性、性能等诸多细节

参考文献