Android 控件RecycleView实现Item反弹

引言：使用RecycleView实现Item滑动的自动反弹，有点类似于ViewPager那样的滑动体验。

时间：2017年03月16日21:26:41

作者：JustDo23

01. 前言

事件分发一直是面试中的常客，只是知道简单的原理却不会实战总是不行的，这方面还是需要继续的学习积累与总结。遇到这样的需求，在一个列表进行滑动之后，需要将顶部第一个显示完整或者显示不全的Item自动的慢慢滚动出屏幕或滚动以完整显示并定位成第一个，这种体验和 ViewPager以及Gallery很像，有大牛使用ListView自定义ReboundListView实现了极好的效果。接下来记录使用RecycleView的实现方式。效果自由体验，仅供参考。

02. 效果图

没有完整代码也没有录制 GIF 图，在网上找个类似效果先体验一下。来源https://github.com/luckyandyzhang/CleverRecyclerView/blob/master/art/s3.gif

类似效果图

02. 滑动监听

对于RecyclerView的滑动监听在其内部有一个监听类OnScrollListener，点击查看源码可以看到这是一个抽象类，内部有两个方法onScrollStateChanged和onScrolled都是空实现的。自定义一个类继承该类并实现方法。

/**
 * RecyclerView 的滑动监听
 *
 * @author JustDo23
 */
public class OnRecyclerViewScrollListener extends RecyclerView.OnScrollListener {

  /**
   * 滑动中回调
   *
   * @param recyclerView 控件对象
   * @param dx           [距离][X轴]
   * @param dy           [距离][Y轴][正数代表向下][负数代表向上]
   */
  @Override
  public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
    super.onScrolled(recyclerView, dx, dy);
    LogUtil.e("onScrolled : " + "dx = " + dx + "dy = " + dy);
  }

  /**
   * 滑动状态发生改变的时候回调
   *
   * @param recyclerView 控件对象
   * @param newState     [状态值][每次滑动时候三个状态都会回调一次][手指拖动(惯性滑动)静止]
   */
  @Override
  public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
    super.onScrollStateChanged(recyclerView, newState);
    LogUtil.e("onScrolled : " + "newState = " + newState);
    switch (newState) {
      case RecyclerView.SCROLL_STATE_IDLE:// 静止
        LogUtil.e("静止静止");
        break;
      case RecyclerView.SCROLL_STATE_DRAGGING:// 手指拖动
        LogUtil.e("手指拖动");
        break;
      case RecyclerView.SCROLL_STATE_SETTLING:// 惯性滑动
        LogUtil.e("惯性滑动");
        break;
    }
  }
}

状态改变的回调有三个状态值，见名知意，很好理解不用过多解释。

03. 添加滑动监听

在对 RecycleView 初始化完之后调用如下代码添加监听

recycle_view.addOnScrollListener(new OnRecyclerViewScrollListener());

另外，添加监听有一个set的方法，已经过时。添加监听之后运行程序，查看Logcat观察打印并总结规律：

只要正在滑动就会回调onScrolled方法

手指一碰触就会返回状态SCROLL_STATE_DRAGGING(手机拖动)
最后停止的时候回返回状态SCROLL_STATE_IDLE(静止)
基本上操作一次滑动的状态顺序是：**从 **SCROLL_STATE_DRAGGING(手机拖动) 到 SCROLL_STATE_SETTLING(惯性滑动) 到 SCROLL_STATE_IDLE(静止)

04. 思路原型

根据总结的规律，状态SCROLL_STATE_DRAGGING和SCROLL_STATE_SETTLING是开始滑动和滑动中的回调，每次滑动结束都是以状态SCROLL_STATE_IDLE(静止)结束的，那就在静止的是判断一下当前第一个Item的显示情况，如果其大半都显示少部分未显示就调用smoothScrollToPosition方法将其全部显示，否则就慢慢滑动到它的下一个位置。

关于状态SCROLL_STATE_SETTLING(惯性滑动)的返回，不使用手指拖动，直接调用scroll之类的方法让RecycleView滑动到指定位置，返回的状态顺序是：**从 **SCROLL_STATE_SETTLING(惯性滑动) 到 SCROLL_STATE_IDLE(静止) 。

这样就会有一次完整的状态顺序是：**从 **SCROLL_STATE_DRAGGING(手机拖动) 到 SCROLL_STATE_SETTLING(惯性滑动) 到 SCROLL_STATE_IDLE(静止) 到SCROLL_STATE_SETTLING(惯性滑动) 到 SCROLL_STATE_IDLE(静止) 。

@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
  switch (newState) {
    case RecyclerView.SCROLL_STATE_IDLE:// 静止
      RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
      if (layoutManager instanceof LinearLayoutManager) {// 只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
        LinearLayoutManager linearLayoutManager = (LinearLayoutManager) layoutManager;
        int firstItemPosition = linearLayoutManager.findFirstVisibleItemPosition();// 获取第一个可见view的位置
        View childView = linearLayoutManager.findViewByPosition(firstItemPosition);// 获取显示的第一个 View
        int childViewHeight = childView.getHeight();
        int childViewTop = childView.getTop();
        if (Math.abs(childViewTop) == recyclerView.getPaddingTop() || Math.abs(childViewTop) == recyclerView.getPaddingTop() * 2) {// 反弹结束
        } else if (Math.abs(childViewTop) >= childViewHeight / 2.0f) {// 定位下一个
          int nextPosition = firstItemPosition + 1;
          recyclerView.smoothScrollToPosition(nextPosition);
        } else {// 定位当前
          recyclerView.smoothScrollToPosition(firstItemPosition);
        }
      }
      break;
    case RecyclerView.SCROLL_STATE_DRAGGING:// 手指拖动
      break;
    case RecyclerView.SCROLL_STATE_SETTLING:// 惯性滑动
      break;
  }
}

获取RecycleView第一个显示的位置等有参考网上的文章。RecycleViewScrollHelper--RecyclerView滑动事件检测的辅助类以及总结和分析几种判断RecyclerView到达底部的方法
除以2是获取到一个childView后以其高度的一般作为分界线。
函数求绝对值是因为childView的Top值有正负两种，负数代表未显示。
在使用RecycleView的时候设置了padding值和分割线的高度，两者相同大小。

05. smoothScrollToPosition方法无效

满心欢喜，本以为功能都要实现了，运行后发现，向上滑动是可以的，基本达到理想效果。向下滑动却不会进行自动滑动到指定的位置，和没有写代码是一样的。各种打印之后发现代码是没有问题的，定位也是没有问题的，就是滑动的smoothScrollToPosition方法失效了。参考文章 Android RecyclerView滚动定位并写出如下代码：

/**
 * 缓慢移动到指定的位置
 *
 * @param position
 */
private void smoothMoveToPosition(RecyclerView recyclerView, int position) {
  RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
  if (layoutManager instanceof LinearLayoutManager) {// 只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
    LinearLayoutManager linearLayoutManager = (LinearLayoutManager) layoutManager;
    int firstItem = linearLayoutManager.findFirstVisibleItemPosition();// 先从RecyclerView的LayoutManager中获取第一项和最后一项的Position
    int lastItem = linearLayoutManager.findLastVisibleItemPosition();
    if (position <= firstItem) {// 当要置顶的项在当前显示的第一个项的前面时
      recyclerView.smoothScrollToPosition(position);
    } else if (position <= lastItem) {// 当要置顶的项已经在屏幕上显示时
      int top = recyclerView.getChildAt(position - firstItem).getTop();
      recyclerView.smoothScrollBy(0, top);
    } else {// 当要置顶的项在当前显示的最后一项的后面时
      recyclerView.smoothScrollToPosition(position);
    }
  }
}

这个方法中有用的就两行。调用smoothScrollBy方法，将定位下一个的代码进行替换就没有问题。其实还有就是最后一个Item的显示，你可能会发现最后一个Item怎么也滑不上来，当然可以修改一下逻辑来解决。项目中有添加footer的需求，就给避免了这样的问题。

06. 接口回调

但滑动中和反弹之后需要有回调获取状态，然后进行相应的业务处理。

/**
 * 反弹监听
 *
 * @author JustDo23
 */
public interface OnReboundListener {

  /**
   * 正在滑动回调
   */
  void onRebounding();

  /**
   * 反弹结束回调
   *
   * @param position 静止的位置
   */
  void onReboundFinish(int position);

}

在OnRecyclerViewScrollListener相应的位置去进行接口的回调。

07. 完整代码

/**
 * RecyclerView 的滑动监听
 *
 * @author JustDo23
 */
public class OnRecyclerViewScrollListener extends RecyclerView.OnScrollListener {

  private OnReboundListener onReboundListener;

  public OnRecyclerViewScrollListener(OnReboundListener onReboundListener) {
    this.onReboundListener = onReboundListener;
  }

  /**
   * 滑动中回调
   *
   * @param recyclerView 控件对象
   * @param dx           [距离][X轴]
   * @param dy           [距离][Y轴][正数代表向下][负数代表向上]
   */
  @Override
  public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
    super.onScrolled(recyclerView, dx, dy);
    LogUtil.e("onScrolled : " + "dx = " + dx + "dy = " + dy);
  }

  /**
   * 滑动状态发生改变的时候回调
   *
   * @param recyclerView 控件对象
   * @param newState     [状态值][每次滑动时候三个状态都会回调一次][手指拖动(惯性滑动)静止]
   */
  @Override
  public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
    super.onScrollStateChanged(recyclerView, newState);
    LogUtil.e("onScrolled : " + "newState = " + newState);
    switch (newState) {
      case RecyclerView.SCROLL_STATE_IDLE:// 静止
        LogUtil.e("静止");
        RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
        if (layoutManager instanceof LinearLayoutManager) {// 只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
          LinearLayoutManager linearLayoutManager = (LinearLayoutManager) layoutManager;
          int totalItemCount = layoutManager.getItemCount();// 当前RecyclerView的所有子项个数
          int firstItemPosition = linearLayoutManager.findFirstVisibleItemPosition();// 获取第一个可见view的位置
          int lastItemPosition = linearLayoutManager.findLastVisibleItemPosition();// 获取最后一个可见view的位置
          View childView = linearLayoutManager.findViewByPosition(firstItemPosition);// 获取显示的第一个 View
          int childViewHeight = childView.getHeight();
          int childViewTop = childView.getTop();
          if (Math.abs(childViewTop) == recyclerView.getPaddingTop() || Math.abs(childViewTop) == recyclerView.getPaddingTop() * 2) {
            if (onReboundListener != null) {// 反弹结束
              onReboundListener.onReboundFinish(firstItemPosition);
            }
          } else if (Math.abs(childViewTop) >= childViewHeight / 2.0f) {// 定位下一个
            int nextPosition = firstItemPosition + 1;
            smoothMoveToPosition(recyclerView, nextPosition);
          } else {// 定位当前
            recyclerView.smoothScrollToPosition(firstItemPosition);
          }

          LogUtil.e("childViewHeight = " + childViewHeight);
          LogUtil.e("totalItemCount = " + totalItemCount);
          LogUtil.e("firstItemPosition = " + firstItemPosition);
          LogUtil.e("lastItemPosition = " + lastItemPosition);
          LogUtil.e("childViewGetTop = " + childView.getTop());
          LogUtil.e("childViewGetY = " + childView.getY());
          LogUtil.e("childViewGetPaddingTop = " + childView.getPaddingTop());
          LogUtil.e("PaddingTop = " + SizeUtil.dip2px(recyclerView.getContext(), 10.0f));
          LogUtil.e("Padding = " + recyclerView.getPaddingTop());
        }
        break;
      case RecyclerView.SCROLL_STATE_DRAGGING:// 手指拖动
        LogUtil.e("手指拖动");
        if (onReboundListener != null) {
          onReboundListener.onRebounding();
        }
        break;
      case RecyclerView.SCROLL_STATE_SETTLING:// 惯性滑动
        LogUtil.e("惯性滑动");
        break;
    }
  }

  /**
   * 缓慢移动到指定的位置
   *
   * @param position
   */
  private void smoothMoveToPosition(RecyclerView recyclerView, int position) {
    RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
    if (layoutManager instanceof LinearLayoutManager) {// 只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
      LinearLayoutManager linearLayoutManager = (LinearLayoutManager) layoutManager;
      int firstItem = linearLayoutManager.findFirstVisibleItemPosition();// 先从RecyclerView的LayoutManager中获取第一项和最后一项的Position
      int lastItem = linearLayoutManager.findLastVisibleItemPosition();
      if (position <= firstItem) {// 当要置顶的项在当前显示的第一个项的前面时
        recyclerView.smoothScrollToPosition(position);
      } else if (position <= lastItem) {// 当要置顶的项已经在屏幕上显示时
        int top = recyclerView.getChildAt(position - firstItem).getTop();
        recyclerView.smoothScrollBy(0, top);
      } else {// 当要置顶的项在当前显示的最后一项的后面时
        recyclerView.smoothScrollToPosition(position);
      }
    }
  }

}

08. 遗留问题

使用 RecycleView 如何获取 Item 分割线的高度
如何禁止 RecycleView 的快速滑动

09. 别人家的代码

在网络上搜索了关键字RecyclerView ViewPager之后再 GitHub 上找到RecyclerViewPager和CleverRecyclerView两个库。因为在CleverRecyclerView中看到类似的想要的效果，就下载下来写了个Demo看了看效果。然后对源码进行了简单研究，主要也是针对滑动事件的。

@Override
public void onScrollStateChanged(int state) {
  super.onScrollStateChanged(state);
  switch (state) {
    case SCROLL_STATE_DRAGGING:
      mCurrentChildView = mCleverRecyclerViewHelper.getCurrentFirstVisibleChild();// 获取第一个显示的View
      mCurrentPosition = getChildAdapterPosition(mCurrentChildView);// 获取这个View在Adapter中的位置
      if (mCurrentChildView != null) {// 如果这个View不是空的，从RecycleView中获取这个View的top值
        mPositionBeforeDragging = mCleverRecyclerViewHelper.getChildCurrentPosition(mCurrentChildView);
      }
      mNeedAdjustAfterScrollStopped = true;// 滑动之后需要进行位置调整
      break;
    case SCROLL_STATE_SETTLING:
      mNeedAdjustAfterScrollStopped = false;
      break;
    case SCROLL_STATE_IDLE:
      if (mNeedAdjustAfterScrollStopped) {// 没有触发fling时，需要再次处理子View的位置偏移
        if (mCurrentChildView != null) {
          float draggingDistance = mCleverRecyclerViewHelper.getChildCurrentPosition(mCurrentChildView) - mPositionBeforeDragging;// 当前的top - 滑动之前的top
          if (mCleverRecyclerViewHelper.isRightScrollTriggered(draggingDistance) || mCleverRecyclerViewHelper.isDownScrollTriggered(draggingDistance)) {
            mCurrentPosition--;// 判断方向是向下滑动，则原来的位置减减
          } else if (mCleverRecyclerViewHelper.isLeftScrollTriggered(draggingDistance) || mCleverRecyclerViewHelper.isUpScrollTriggered(draggingDistance)) {
            mCurrentPosition++;// 判断方向是向上滑动，则原来的位置加加
          }

          int safeTargetPosition = mCleverRecyclerViewHelper.getTargetPositionSafely(mCurrentPosition, getAdapter().getItemCount());// 新位置和总数比较获取安全位置
          smoothScrollToPosition(safeTargetPosition);
        }
      }
      break;
  }
}

注释是后来打上去的，是对源码的简单理解。自定义CleverRecyclerView继承RecyclerView后重写了fling方法smoothScrollToPosition方法onScrollStateChanged方法等。

手指拖拽滑动，当手指触碰的时候获取一下当前显示的位置，手指松开回调静止状态，计算手指拖拽的距离，并根据距离判断方向，向上滑动则原来的位置加加，向下滑动则原来的位置减减。
手指滑动产生惯性滑动会先回调SCROLL_STATE_SETTLING状态，当静止时候是需要进行位置调整的，很奇怪每次都能滑动到指定位置，回头看fling方法有相应的位置调整。

另外在阅读代码的时候发现有一个专门的Helper类需要一个RecyclerView类的对象去支持，辅助类类似工具类，设计模式什么的懂的不多，感觉这 Helper类像一个工具类将很多需要计算或判断的代码从自定义类中抽取出来，很有味道。

10. 拓展文章

最后编辑于：2017.12.06 03:51:46

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 206,482评论 6赞 481
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 88,377评论 2赞 382
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 152,762评论 0赞 342
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 55,273评论 1赞 279
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 64,289评论 5赞 373
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 49,046评论 1赞 285
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 38,351评论 3赞 400
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,988评论 0赞 259
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 43,476评论 1赞 300
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,948评论 2赞 324
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 38,064评论 1赞 333
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,712评论 4赞 323
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,261评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 30,264评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,486评论 1赞 262
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 45,511评论 2赞 354
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,802评论 2赞 345