RecycleViewScrollHelper--RecyclerView滑动事件检测的辅助类

目录

概述

这是一个关于RecycleView滑动事件的辅助类,该辅助类可以检测RecycleView滑动到顶部或者底部的状态.
可用于实现RecycleView加载更多或者刷新(虽然刷新可以直接用SwipeRefreshLayout).也可用于某些滑动相关的需求,如FloatingActionButton的隐藏与显示之类的.


关于RecycleView的滑动监听

RecycleView本身已经提供了滑动的监听接口,OnScrollListener,这个接口包含了以下的方法.

//当recycleView的滑动状态改变时回调
public void onScrollStateChanged(RecyclerView recyclerView, int newState){}
//当RecycleView滑动之后被回调
public void onScrolled(RecyclerView recyclerView,int dx, int dy){}

RecycleView的滑动状态

/**
 * The RecyclerView is not currently scrolling.
 * 当前的recycleView不滑动(滑动已经停止时)
 */
public static final int SCROLL_STATE_IDLE = 0;

/**
 * The RecyclerView is currently being dragged by outside input such as user touch input.
 * 当前的recycleView被拖动滑动
 */
public static final int SCROLL_STATE_DRAGGING = 1;

/**
 * The RecyclerView is currently animating to a final position while not under
 * outside control.
 * 当前的recycleView在滚动到某个位置的动画过程,但没有被触摸滚动.调用 scrollToPosition(int) 应该会触发这个状态
 */
public static final int SCROLL_STATE_SETTLING = 2;

由以上状态我们可以根据不同的状态去判断RecycleView当前的位置或者是滚动状态.


关于滑动位置的监听

我们需要确定的是RecycleView是否已经滑动到底部或者是顶部.
由以上提及的状态我们可以确定,当前RecycleView滑动到顶部或者底部时,其滚动状态都是静止的,这时状态应该是SCROLL_STATE_IDLE.
确定了状态,下面需要确定的就是当前的item是否为顶部或者是底部的item?
关于这个问题,其实RecycleView已经有相关的方法可以查询到了(严格来说应该是RecycleViewLayoutManager),网上已经有很多相关的博客说明.这里也是参考了一下一些博客,这里给出一个地址,可以了解一下,下面也会提及如何检测,如果觉得链接内容太多可以跳过.
参考链接

特别说明,为了避免混乱
1.这里使用itemView表示adapter里每一个position对应的view;
2.position都是指adapter中的数据的位置
3.使用childView表示RecycleView缓存复用的子view


检测边界的itemView

关于itemView的位置确定,可以通过LinearLayoutManager获取到当前显示的view对应adapter中的position.

LinearLayoutManager linearManager = (LinearLayoutManager) layoutManager;
//查找最后一个可见的item的position
int lastItemPosition = linearManager.findLastVisibleItemPosition();
//查找第一个可见的item的position
int firstItemPosition =linearManager.findFirstVisibleItemPosition();

这里查找到的position也就是adapter中的位置.因此就可以通过position来确定当前的itemView是顶部还底部了.


完整的检测方式(onScrollStateChanged)

//onScrollStateChanged 方法
RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
//判断是当前layoutManager是否为LinearLayoutManager
//只有LinearLayoutManager才有查找第一个和最后一个可见view位置的方法
if (layoutManager instanceof LinearLayoutManager) {
    LinearLayoutManager linearManager = (LinearLayoutManager) layoutManager;
    //获取最后一个可见view的位置
    int lastItemPosition = linearManager.findLastVisibleItemPosition();
    //获取第一个可见view的位置
    int firstItemPosition =linearManager.findFirstVisibleItemPosition();
    if (newState == RecyclerView.SCROLL_STATE_IDLE && lastItemPosition + 1 == adapter.getItemCount()) {
    //最后一个itemView的position为adapter中最后一个数据时,说明该itemView就是底部的view了
    //需要注意position从0开始索引,adapter.getItemCount()是数据量总数
    } 
    //同理检测是否为顶部itemView时,只需要判断其位置是否为0即可
    if (newState == RecyclerView.SCROLL_STATE_IDLE && firstItemPosition == 0) {}

以上是简单的顶部/底部判断方式.


简单判断方式的缺点

以上已经介绍了如何判断RecycleView滑动到顶部和底部的方式.但这个判断方式是有缺陷的.问题在于RecycleView的可见itemView的查找上.

itemView的可见问题

RecycleView中的itemView是可大可小的,这个取决于我们的实际使用场景及业务.当itemView的内容比较多时,将会占据相当一部分RecycleView的界面.所以我们往往存在这种情况:
某些itemView会在滑动过程中只显示一部分或者一半
但是这种情况下,该itemView还是属于一个可见(visible).

任何时候一个itemView只要有任何一部分显示在RecycleView上时,该itemView都是可见的

回到我们之前查找边界itemView的方法中,查找边界用的方法是:

linearLayoutManager.findFirstVisibleItemPosition();

所以说到这里应该明白了仅管第一个itemView只有一点点显示在RecycleView中时,该itemView也是会被保留并查找到的,此时返回的位置确实是0(第一个itemView的position).

在大部分情况下,这种情况并没有很大的问题.但是在某些情况下,这样的情况会使我们的逻辑或者业务出现不正常的表现现象.


某些需求情况

有以下一种情况:

  • 需求
    当滑动到底部或者中途时,由于item可能很多,重新滑动回去是很麻烦的情况,所以会设置一个回到顶部的按钮.当滑动到第一项itemView时,取消回到顶部按钮的显示.

  • 导致的问题
    通过以上的说明,有可能出现以下的情况,当滑动到第一项itemView显示了一点点的时候回到顶部的按钮就消失了.

  • 解决方案
    如果我们希望这个按钮不是这么快消失而是第一项itemView显示完全显示或者至少大部分显示时才消失,那么就需要检测完全显示的子view

  • 示例图片
    这里写图片描述
    第一次不管怎么滑动,除非完全滑动到顶部,否则按钮不会消失.
    切换不完全检测显示的childView之后,只要第一项(child-0)在界面中出现任何一部分,按钮都会消失,这就是没有检测完全的childView的弊端.


检测完全显示的子view

针对以上可能”误杀”的触摸事件,我们可以进一步地去确定和优化检测的条件.
首先回顾一下检测的条件:

  • 检测当前RecycleView的滑动状态
  • 检测当前是否滑动到了顶部或者底部

以上两个检测条件还是不会改变的,但是第二个检测条件可进一步优化.下面以如何更准确地检测是否滑动到第一项itemView为例.
我们已经取到RecycleView第一个itemView,现在已经确定了第一项itemView已经处于显示的状态,但是可能该itemView仅仅只是显示了一小部分.我们希望该itemView是大部分可见或者完全可见.

解决关键
事实上,只要该itemView可见,说明该itemView至少有一部分是被绘制了,而只要进行了绘制,就可以得到该itemView相关的一些坐标属性,从而与RecycleView进行比较即可判断该itemView是否完全显示或者部分显示.

实现步骤

  • 首先,我们需要获取该itemView.由于该itemView可见并且是第一项itemView,所以必定在RecycleView的第一个子view(也就是缓存的第一个childView).
  • 其次,我们需要获取第一项itemView的顶部坐标,当该itemView完全显示在RecycleView中时,该顶部坐标必然也在RecycleView的顶部坐标内;否则该顶部坐标将小于RecycleView的顶部坐标.

注意点

这里有需要注意的地方,子view是依赖于RecycleView绘制的,所以获取到的子view的顶部坐标是相对于RecycleView而言的坐标,RecycleView的顶部坐标也是相对于自身而言,所以RecycleView的顶部坐标应该是0

//获取 RecycleView第一个子view
View childView=recycleView.getChildAt(0);
//获取第一个子view的顶部坐标
int top=childView.getTop();
//获取 RecycleView的顶部坐标
//正常来说RecycleView的顶部坐标应该是0,但是严格来考虑,当RecycleView设置了paddingTop时,所有子view的绘制将以paddingTop的位置为起始位置,所以实际的顶部应该是paddingTop的高度的数值.
int topEdge=recycleView.getPaddingTop();
if(top>=topEdge){
    //子view完全显示
}

以上是关于第一项itemView是否完全检测的方式,对于最后一项itemView检测方式也是类似的,只是将检测的itemView的top换成bottom,因为此时需要检测的最后一项itemView的最底边小于RecycleView的底部坐标时(实际上就是RecycleView的高),说明最后一项完全显示了.


检测满屏数据时的RecycleView

通过以上说明,我们已经可以检测顶部itemView及底部itemView完全显示在界面上时的情况了,可以避免一些不正常的现象.
但这并不会完全解决所有的情况,在某些情况下可能还是会出现一些意想不到的问题.
假设有以下的情况:

  • 需求
    RecycleView只有一个item,并且item的高度不足以填充满RecycleView的高度(也就是还有空白的空间可以显示其它的item),这种情况下只要对RecycleView进行任意的滑动,结果会是什么?

  • 原因
    其实从以上的分析我们可以确定在这种情况下不管怎么滑动都会触发滑动到顶部或者是底部的事件的.原因在于:
    此时顶部及底部的itemView是同一个view并且已经完全显示在RecycleView中,RecycleView还有空余的空白空间
    在这种情况下只要进行了滑动,不管是什么类型的滑动最终都会成功检测到顶部itemView或者是底部itemView

  • 解决方案
    如果为了避免这种情况,我们就需要对在检测时多进行一步,若当前的RecycleView显示的itemView不满屏的情况下,其实并不存在滑动的说法(没有加载更多,因为根本数据还没有满屏显示),至于下拉刷新的,还是可以的,但一般都会使用SwipeRefreshLayout实现下拉刷新了.因此这里主要考虑的是关于滑动到底部加载更多的问题.

  • 示例图片
    这里写图片描述
    图中RecycleView中的item并没有完全填充界面,有toast出现时都是进行了滑动的.
    可见在没有检测是否满屏显示的情况下,只要有滑动都会触发滑动到顶部或者底部的事件(在这里有切换了优先检测的过程,请注意toast).
    当选择两个事件可以同时检测触发时,可见toast提示的文本是提示了两次的


实现步骤

以下针对是否滑动到底部,暂不考虑滑动到顶部的情况.

  • 参考完全显示子view的检测,对于底部,我们只要确保RecycleView最后一个子view底部坐标小于RecycleView底部坐标即可确定其完全显示.
  • 之后我们需要确定的是:是否有足够的子view填充了整个RecycleView.同理只要确定第一个子view的顶部坐标小于RecycleView顶部坐标,此时第一个子view已经部分不可见,说明RecycleView是完全被填充的.

注意以下所有的坐标都是基于RecycleView本身,是相对于RecycleView的坐标,因为所有的子view都是在RecycleView内部绘制的

//获取最后一个childView
View lastChildView = recyclerView.getChildAt(childCount - 1);
//获取第一个childView
View firstChildView = recyclerView.getChildAt(0);
int top = firstChildView.getTop();
int bottom = lastChildView.getBottom();
 //recycleView显示itemView的有效区域的bottom坐标Y
int bottomEdge = recyclerView.getHeight() - recyclerView.getPaddingBottom();
 //recycleView显示itemView的有效区域的top坐标Y
int topEdge = recyclerView.getPaddingTop();
 //第一个view的顶部小于top边界值,说明第一个view已经部分或者完全移出了界面
 //最后一个view的底部小于bottom边界值,说明最后一个view已经完全显示在界面
 //若满足这两个条件,说明所有子view已经填充满了recycleView,recycleView可以"真正地"滑动
if (bottom <= bottomEdge && top < topEdge) {
    //满屏的recyceView
}

其它

设置检测滑动边界时的容差值.在检测完全显示的childView时,检测的方式是当childView边界完全显示在界面中时才会检测成功.这就导致了一个可能的情况是,当只差一点点滑动到边界时也不会检测成功.这里的灵敏度要求很高.
容差值的出现就是为了解决这种情况,当需要检测时的灵敏度不需要这么高时,允许在边界一定范围内即可检测成功时,可以设置容差值.
容差值会使得更容易判断成立.容差值必须为0或者正数,默认为0.

//设置顶部检测的容差值
public void setTopOffsetFaultTolerance(int offset);
//设置底部检测的容差值
public void setBottomOffsetFaultTolerance(int offset);

示例:当设置容差值为item的一半高度时,则在顶部或者底部item超过一半滑出界面时即可以触发回调事件.


完整地检测满屏并滑动到底部(或者顶部)

将以上两个检测满屏检测滑动到底部的方法组合起来即可.
最后附上更加具体的检测方式:

  • 可以设置先检测滑动到底部还是顶部
  • 可以设置在先检测到某一种情况时是否还继续检测另一种情况(栽些情况下可能需要同时检测是否滑动到顶部及底部)
  • 可以设置是否检测满屏的情况(非满屏情况下不触发滑动事件)
  • 可以设置检测滑动到顶部/底部的容差值(即扩大检测范围)

GitHub地址

https://github.com/CrazyTaro/RecycleViewAdatper

资源下载

不想下载github项目的,或者不使用AS只需要类文件的,可以到以下下载地址直接下载类文件:
http://download.csdn.net/detail/u011374875/9556686

回到目录

本页内容版权归属为原作者,如有侵犯您的权益,请通知我们删除。
这个小案例建议在手机上运行。 package com.example.camera;import java.io.File;import android.net.Uri;import android.os.Bundle;import android.os.Environment;import android.provider.MediaStore;import android.app.Activity;import android.content.Intent;import android.view.Me
简介 NSScanner是一个类,用于在字符串中扫描指定的字符,尤其是把它们翻译/转换为数字和别的字符串。可以在创建NSScaner时指定它的string属性,然后scanner会按照你的要求从头到尾地扫描这个字符串的每个字符。 NSScanner官方文档 NSScanner类是一个类簇的抽象父类,该类簇为一个从NSString对象扫描值的对象提供了程序接口。 NSScanner对象把NSString 对象的的字符解释和转化成 number和string 类型的值。在创建NSScanner对象的时候为它分
目录 概述 StickHeaderItemDecoration 是用于显示固定头部的item装饰类,扩展来自系统的 ItemDecoration .本文参考了一部分 sticky-headers-recyclerview 原理 绘制头部 固定头部的 ItemDecoration 本质是在 RecycleView 上覆盖一个界面.该界面没有随着滑动变动所以看起来就像一个固定的头部. 绘制item间隔 ItemDecoration 也可以实现每个item之间的间隔的绘制(比如分隔线之类的),这种情况下就不是在
android中网络请求回来数据之后,我们要对其解析。请求的返回的结果格式如果不是自定义协议;那么返回的数据通常是xml,json,html形式的数据了。 下面就是针对上面3种格式进行解析。 xml解析使用工具:在android中推荐使用pull解析,还有其他的dom,sax解析。 json解析使用工具:推荐使用Fastjson,由阿里提供。还有其他的如JackSon,Gson解析。 html解析使用工具:推荐使用Jsoup,还有其他的如HtmlParser;关于使用这个,网络上的爬虫就是这样子的。 1.
一个SpriteKit项目在其他设备上运行都无问题(无论是真机或是模拟器),但是在iPhone6 Plus上会出现精灵对象纹理被过度放大的现象: 从上图中大家可以看到无论是主角或是道具球都过大了. 看了一下精灵图片是放在atlas纹理集文件夹中的: 可以看到PowerUp和Player都有对应缩放的版本:Player.png,Player@2x.png以及Player@3x.png. 在各个图片的属性中检查图片的尺寸也都正确,看不出神马问题… 找到SKSpriteNode对象初始化的代码看看: let o
转载请标明出处: 一片枫叶的专栏 本文中我将介绍一下我自己封装的一个小的工具类库:按钮点击事件类库。 作用: 该类库可以防止按钮重复点击,可以判断网络状态,可以判断用户登录状态,以及自定义验证条件等等。 说明: 其实现的核心原理就是通过自定义实现自身的OnClickListener类,并重写其中的onClick方法,在onClick方法中执行相应的判断逻辑之后回调我们自定义的抽象方法。 具体效果如下图所示: 使用方式 屏蔽多次点击事件 /** * 测试快速点击事件 */ fastButton.setOnC

算法基础:排序与查找 - 2016-06-24 17:06:40

1、直接插入排序 1.1、基本思想: 在要排序的一组数中,假设前面(n-1) [n=2] 个数已经是排好顺序的,现在要把第n个数插到前面的有序数中,使得这n个数也是排好顺序的;如此反复循环,直到全部排好顺序。 1.2、实现思路: INSERTION_SORT( A )for i = 2 to n j = i- 1 key = A [i] while j 0 A [j] key A [j+ 1 ] = A [j] j-- A [j+ 1 ] = key 1.3、算法实现: public static int
【腾讯TMQ】5小时搞定谷歌原生自动化框架UiAutomator1.0 前言 谷歌对UI测试(UI Tetsting)的概念是:确保用户在一系列操作过程中(例如键盘输入、点击菜单、弹出对话框、图像显示以及其他UI控件的改变),你的应用程序做出正确的UI响应。 UI测试(功能测试、黑盒测试)的好处是不需要测试者了解应用程序的内部实现细节,只需要知道当执行了某些特定的动作后是否会得到其预期的输出。这种测试方法,在团队合作中可以更好地分离的开发和测试角色。然而常见的UI测试多是以手动方式去执行,然后去验证程序是
一、资源管理器介绍     现在在一些移动终端上面都会有自带的资源管理器,其实其并非是 Android 系统自带,而是手机产商与 app 开发商的合作而导致融合,借助第三方的开发软件预装在出厂的手机,是新时代下的另一个霸王条款,还不能自行删除,十分麻烦。 背景铺垫完毕,由于十分讨厌这种不公平的手段,为此自行写一个实现文件资源管理器,功能基本上实现,实用不美观,不喜勿喷! 二、实现函数详解 1 、显示文件列表 /** * 扫描显示文件列表 * @param path */ private void show
作者 : 韩曙亮 转载请注明出处 :  http://blog.csdn.net/shulianghan/article/details/50824912 相关地址介绍 :  --  Universal Image Loader 项目 GitHub 官方地址  :  https://github.com/nostra13/Android-Universal-Image-Loader  . -- Universal Image Loader 项目完整中文注释版, 已经将所有类都进行了中文注释, 适合源码学习