Android中RecyclerView实现分页滚动的方法详解

一、需求分析

最近公司项目要实现一个需求要满足以下功能：

      1）显示一个 list 列表， item 数量不固定。

      2）实现翻页功能，一次翻一页。

      3）实现翻至某一页功能。

下面介绍通过 RecyclerView 实现该需求的实现过程（效果图如下）。

二、功能实现

2.1 OnTouchListener 记录当前开始滑动位置

要实现翻页滑动首先我们要确定是向前翻页还是向后翻页，这里通过记录开始翻页前当前的位置和滑动后的位置比较即可得知，下面选择手指触摸按下时滑动的位置为当前开始滑动位置：

 //当前滑动距离
 private int offsetY = 0;
 private int offsetX = 0;
 //按下屏幕点
 private int startY = 0;
 private int startX = 0;
@Override
  public boolean onTouch(View v, MotionEvent event) {
   //手指按下的时候记录开始滚动的坐标
   if (event.getAction() == MotionEvent.ACTION_DOWN) {
    //手指按下的开始坐标
    startY = offsetY;
    startX = offsetX;
   }
   return false;
  }
 }

好了，当我们确定了滑动方向，下面要考虑的就是如何实现滑动？

2.2 scrollTo(int x, int y) 和 scrollBy(int x, int y) 实现滑动

滑动我们最容易想到的方法就是 scrollTo(int x, int y) 和 scrollBy(int x, int y) 这两个方法， scrollTo(int x, int y) 是将当前 View 的内容滑动至某一位置， scrollBy(int x, int y) 是将当前 View 内容相对于当前位置滑动一定的距离，其实 scrollBy(int x, int y) 内部是调用了 scrollTo(int x, int y) 方法实现的 一开始想用 scrollTo(int x, int y) 去实现，但是简单看了下源码发现， RecyclerView 不支持这个方法：

@Override
 public void scrollTo(int x, int y) {
  Log.w(TAG, "RecyclerView does not support scrolling to an absolute position. "
    + "Use scrollToPosition instead");
 }

所以这里我们就选择使用 scrollBy(int x, int y) 去实现滑动。

2.3 OnFlingListener 和 OnScrollListener 调用滑动时机

上面我们决定使用 scrollBy(int x, int y) 去实现滑动，那么现在我们就要确定 scrollBy(int x, int y) 这个方法的调用时机，我们知道当我们滑动 RecyclerView 的时候一般分为两种情况，一种是手指在屏幕上面缓慢滑动（Scroll），另一种是飞速滑动（onFling），经过一番查阅，发现 RecyclerView 中有这两种状态的监听，那么我们一起看一下这两种状态的方法定义，先看 onFling(int velocityX, int velocityY) ：

Note: 由于使用了 RecyclerView 的 OnFlingListener，所以 RecycleView 的版本必须要 recyclerview-v7:25.0.0 以上。

/**
 * This class defines the behavior of fling if the developer wishes to handle it.
 * <p>
 * Subclasses of {@link OnFlingListener} can be used to implement custom fling behavior.
 *
 * @see #setOnFlingListener(OnFlingListener)
 */
 public static abstract class OnFlingListener {
  /**
  * Override this to handle a fling given the velocities in both x and y directions.
  * Note that this method will only be called if the associated {@link LayoutManager}
  * supports scrolling and the fling is not handled by nested scrolls first.
  *
  * @param velocityX the fling velocity on the X axis
  * @param velocityY the fling velocity on the Y axis
  *
  * @return true if the fling washandled, false otherwise.
  */
  public abstract boolean onFling(int velocityX, int velocityY);
 }

方法的注释写的也很清楚，当这个方法被调用并且返回 true 的时候系统就不处理滑动了，而是将滑动交给我们自己处理。所以我们可以监听这个方法，当我们执行快速滑动的时候在这个方法里面计算要滑动的距离并执行 scrollBy(int x, int y) 实现滑动，然后直接返回 true，表示滑动我们自己处理了，不需要系统处理。

处理代码如下：

 //当前滑动距离
 private int offsetY = 0;
 private int offsetX = 0;
 //按下屏幕点
 private int startY = 0;
 private int startX = 0;
 //最后一个可见 view 位置
 private int lastItemPosition = -1;
 //第一个可见view的位置
 private int firstItemPosition = -2;
 //总 itemView 数量
 private int totalNum;
@Override
  public boolean onFling(int velocityX, int velocityY) {
   if (mOrientation == ORIENTATION.NULL) {
    return false;
   }
   //获取开始滚动时所在页面的index
   int page = getStartPageIndex();
   //记录滚动开始和结束的位置
   int endPoint = 0;
   int startPoint = 0;
   //如果是垂直方向
   if (mOrientation == ORIENTATION.VERTICAL) {
    //开始滚动位置，当前开始执行 scrollBy 位置
    startPoint = offsetY;
    if (velocityY < 0) {
     page--;
    } else if (velocityY > 0) {
     page++;
    } else if (pageNum != -1) {
     if (lastItemPosition + 1 == totalNum) {
      mRecyclerView.scrollToPosition(0);
     }
     page = pageNum - 1;
    }
    //更具不同的速度判断需要滚动的方向
    //一次滚动一个 mRecyclerView 高度
    endPoint = page * mRecyclerView.getHeight();
   } else {
    startPoint = offsetX;
    if (velocityX < 0) {
     page--;
    } else if (velocityX > 0) {
     page++;
    } else if (pageNum != -1) {
     if (lastItemPosition + 1 == totalNum) {
      mRecyclerView.scrollToPosition(0);
     }
     page = pageNum - 1;
    }
    endPoint = page * mRecyclerView.getWidth();
   }
   //使用动画处理滚动
   if (mAnimator == null) {
    mAnimator = ValueAnimator.ofInt(startPoint, endPoint);
    mAnimator.setDuration(300);
    mAnimator.addUpdateListener(new ValueAnimator.AnimatorUpdateListener() {
     @Override
     public void onAnimationUpdate(ValueAnimator animation) {
      int nowPoint = (int) animation.getAnimatedValue();
      if (mOrientation == ORIENTATION.VERTICAL) {
       int dy = nowPoint - offsetY;
       if (dy == 0) return;
       //这里通过RecyclerView的scrollBy方法实现滚动。
       mRecyclerView.scrollBy(0, dy);
      } else {
       int dx = nowPoint - offsetX;
       mRecyclerView.scrollBy(dx, 0);
      }
     }
    });
    mAnimator.addListener(new AnimatorListenerAdapter() {
     //动画结束
     @Override
     public void onAnimationEnd(Animator animation) {
      //回调监听
      if (null != mOnPageChangeListener) {
       mOnPageChangeListener.onPageChange(getPageIndex());
      }
      //滚动完成，进行判断是否滚到头了或者滚到尾部了
      RecyclerView.LayoutManager layoutManager = mRecyclerView.getLayoutManager();
      //判断是当前layoutManager是否为LinearLayoutManager
      // 只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
      if (layoutManager instanceof LinearLayoutManager) {
       LinearLayoutManager linearManager = (LinearLayoutManager) layoutManager;
       //获取最后一个可见view的位置
       lastItemPosition = linearManager.findLastVisibleItemPosition();
       //获取第一个可见view的位置
       firstItemPosition = linearManager.findFirstVisibleItemPosition();
      }
      totalNum = mRecyclerView.getAdapter().getItemCount();
      if (totalNum == lastItemPosition + 1) {
       updateLayoutManger();
      }
      if (firstItemPosition == 0) {
       updateLayoutManger();
      }
     }
    });
   } else {
    mAnimator.cancel();
    mAnimator.setIntValues(startPoint, endPoint);
   }
   mAnimator.start();
   return true;
  }
 }

再看 OnScrollListener 滚动监听方法：

public abstract static class OnScrollListener {
  /**
  * Callback method to be invoked when RecyclerView's scroll state changes.
  *
  * @param recyclerView The RecyclerView whose scroll state has changed.
  * @param newState  The updated scroll state. One of {@link #SCROLL_STATE_IDLE},
  *      {@link #SCROLL_STATE_DRAGGING} or {@link #SCROLL_STATE_SETTLING}.
  */
  public void onScrollStateChanged(RecyclerView recyclerView, int newState){}
  /**
  * Callback method to be invoked when the RecyclerView has been scrolled. This will be
  * called after the scroll has completed.
  * <p>
  * This callback will also be called if visible item range changes after a layout
  * calculation. In that case, dx and dy will be 0.
  * 滚动完成调用
  * @param recyclerView The RecyclerView which scrolled.
  * @param dx The amount of horizontal scroll.
  * @param dy The amount of vertical scroll.
  */
  public void onScrolled(RecyclerView recyclerView, int dx, int dy){}
 }

这个监听类主要有两个方法一个是 onScrollStateChanged(RecyclerView recyclerView, int newState) 滚动状态发生变化调用， onScrolled(RecyclerView recyclerView, int dx, int dy) RecyclerView 发生滚动和滚动完成调用。有了这两个监听，当我们进行缓慢滑动我们就可以在 onScrollStateChanged(RecyclerView recyclerView, int newState) 中监听滑动如果结束并且超过一定距离去执行翻页，而通过 onScrolled(RecyclerView recyclerView, int dx, int dy) 方法可以记录当前的滑动距离。

处理方法如下：

@Override
  public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
   //如果滑动停止
   if (newState == RecyclerView.SCROLL_STATE_IDLE && mOrientation != ORIENTATION.NULL) {
    boolean move;
    int vX = 0, vY = 0;
    if (mOrientation == ORIENTATION.VERTICAL) {
     int absY = Math.abs(offsetY - startY);
     //如果滑动的距离超过屏幕的一半表示需要滑动到下一页
     move = absY > recyclerView.getHeight() / 2;
     vY = 0;
     if (move) {
      vY = offsetY - startY < 0 ? -1000 : 1000;
     }
    } else {
     int absX = Math.abs(offsetX - startX);
     move = absX > recyclerView.getWidth() / 2;
     if (move) {
      vX = offsetX - startX < 0 ? -1000 : 1000;
     }
    }
    //调用滑动
    mOnFlingListener.onFling(vX, vY);
   }
  }
 @Override
  public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
   //滚动结束记录滚动的偏移量
   //记录当前滚动到的位置
   offsetY += dy;
   offsetX += dx;
  }
 }

到这里我们要实现滑动的方法和时机基本就搞定了，剩下的就是滑动位置计算和滑动效果实现，滑动位置计算就是一次滑动一整页，这个没什么可说的，所以简单说下实现弹性滑动效果。

2.4 ValueAnimator 实现弹性滑动效果

我们知道如果我们直接调用 scrollBy(int x, int y) 这个方法去滑动，那么是没有缓慢滑动的效果，看着有点愣，所以这里我们通过 ValueAnimator 这个类来实现缓慢滑动的效果，这个就很简单了，直接贴代码：

if (mAnimator == null) {
    mAnimator = ValueAnimator.ofInt(startPoint, endPoint);
    mAnimator.setDuration(300);
    mAnimator.addUpdateListener(new ValueAnimator.AnimatorUpdateListener() {
     @Override
     public void onAnimationUpdate(ValueAnimator animation) {
      int nowPoint = (int) animation.getAnimatedValue();
      if (mOrientation == ORIENTATION.VERTICAL) {
       int dy = nowPoint - offsetY;
       if (dy == 0) return;
       //这里通过RecyclerView的scrollBy方法实现滚动。
       mRecyclerView.scrollBy(0, dy);
      } else {
       int dx = nowPoint - offsetX;
       mRecyclerView.scrollBy(dx, 0);
      }
     }
    });

2.5 翻页至某一页

这里翻页至某一页的实现有了上面的基础就很好实现了，就是直接调用 我们已经实现好了的 onFling(int velocityX, int velocityY) 方法，然后把页数传递过去计算一下就可以了 ：

public void setPageNum(int page) {
 this.pageNum = page;
 mOnFlingListener.onFling(0, 0);
}

到这里前面说的功能已经全部实现完毕.

具体代码细节请见：

github 地址： pagerecyclerview

本地下载：点击这里

总结

以上就是这篇文章的全部内容了，希望本文的内容对各位Android开发者们能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对的支持。

# recyclerview分页滚动  # recyclerview  # 分页  # recyclerview分页加载  # Android中实现多行、水平滚动的分页的Gridview实例源码  # Android之ListView分页加载数据功能实现代码  # Android实现ListView分页自动加载数据的方法  # android实现listview分页的方法  # Android Recyclerview实现水平分页GridView效果示例  # Android实现简单的分页效果  # Android提高之SQLite分页表格实现方法  # Android开发中滑动分页功能实例详解  # Android端代码量非常小的分页加载库  # 翻页  # 按下  # 当我们  # 第一个  # 好了  # 这两个  # 这两种  # 就可以  # 看着  # 直接调用  # 很好  # 看了  # 本地下载  # 在这个  # 下一页  # 不需要  # 就不  # 两种  # 中有  # 我们可以 

相关文章： 哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？  如何访问已购建站主机并解决登录问题？  C++时间戳转换成日期时间的步骤和示例代码  寿县云建站：智能SEO优化与多行业模板快速上线指南  建站之星手机一键生成：多端自适应+小程序开发快速建站指南  网站制作费用多少钱,一个网站的运营，需要哪些费用？  宝盒自助建站智能生成技巧：SEO优化与关键词设置指南  小自动建站系统：AI智能生成+拖拽模板，多端适配一键搭建  免费制作统计图的网站有哪些,如何看待现如今年轻人买房难的情况？  网页制作模板网站推荐,网页设计海报之类的素材哪里好？  如何快速搭建个人网站并优化SEO？  上海网站制作网站建设公司,建筑电工证网上查询系统入口？  如何快速配置高效服务器建站软件？  如何在阿里云通过域名搭建网站？  如何在景安云服务器上绑定域名并配置虚拟主机？  个人网站制作流程图片大全,个人网站如何注销？  如何基于云服务器快速搭建个人网站？  如何在云虚拟主机上快速搭建个人网站？  在线流程图制作网站手机版,谁能推荐几个好的CG原画资源网站么？  Android使用GridView实现日历的简单功能  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊？  弹幕视频网站制作教程下载,弹幕视频网站是什么意思？  制作电商网页,电商供应链怎么做？  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  制作公司内部网站有哪些,内网如何建网站？  高端网站建设与定制开发一站式解决方案 中企动力  潍坊网站制作公司有哪些,潍坊哪家招聘网站好？  武汉网站制作费用多少,在武汉武昌，建面100平方左右的房子，想装暖气片，费用大概是多少啊？  建站为何优先选择香港服务器？  建站之星安全性能如何？防护体系能否抵御黑客入侵？  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗？  成都品牌网站制作公司,成都营业执照年报网上怎么办理？  如何在阿里云虚拟机上搭建网站？步骤解析与避坑指南  建站一年半SEO优化实战指南：核心词挖掘与长尾流量提升策略  如何通过VPS搭建网站快速盈利？  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设？  ,sp开头的版面叫什么？  如何在万网主机上快速搭建网站？  零基础网站服务器架设实战：轻量应用与域名解析配置指南  如何破解联通资金短缺导致的基站建设难题？  制作宣传网站的软件,小红书可以宣传网站吗？  建站之星收费标准详解：套餐费用及年费价格表一览  建站之星客服服务时间及联系方式如何？  南宁网站建设制作定制,南宁网站建设可以定制吗？  如何通过FTP服务器快速搭建网站？  制作门户网站的参考文献在哪,小说网站怎么建立？  做企业网站制作流程,企业网站制作基本流程有哪些？  c++怎么实现高并发下的无锁队列_c++ std::atomic原子变量与CAS操作【详解】  网站视频怎么制作,哪个网站可以免费收看好莱坞经典大片？  魔毅自助建站系统：模板定制与SEO优化一键生成指南