利用RecyclerView.ItemDecoration实现顶部悬浮效果

支持

• LinearLayoutManager
• GridLayoutManager
• 点击事件
• 分割线

添加依赖

项目要求： minSdkVersion >= 14. 在你的build.gradle中 :

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {
    compile 'com.github.Gavin-ZYX:StickyDecoration:1.6.1'
}

最新版本

使用

文字悬浮——StickyDecoration

注意 使用 recyclerView.addItemDecoration()之前，必须先调用 recyclerView.setLayoutManager()；

代码：

GroupListener groupListener = new GroupListener() {
    @Override
    public String getGroupName(int position) {
        //获取分组名
        return mList.get(position).getProvince();
    }
};
StickyDecoration decoration = StickyDecoration.Builder
        .init(groupListener)
        //重置 span（使用 GridLayoutManager 时必须调用）
        //.resetSpan(mRecyclerView, (GridLayoutManager) manager)
        .build();
...
mRecyclerView.setLayoutManager(manager);
//需要在 setLayoutManager()之后调用 addItemDecoration()
mRecyclerView.addItemDecoration(decoration);

效果：

支持的方法：

方法	功能	默认
setGroupBackground	背景色	#48BDFF
setGroupHeight	高度	120px
setGroupTextColor	字体颜色	Color.WHITE
setGroupTextSize	字体大小	50px
setDivideColor	分割线颜色	#CCCCCC
setDivideHeight	分割线高宽度	0
setTextSideMargin	边距(靠左时为左边距 靠右时为右边距)	10
setHeaderCount	头部 Item 数量（仅 LinearLayoutManager）	0
setSticky	是否需要吸顶效果	true

方法	功能	描述
setOnClickListener	点击事件	设置点击事件，返回当前分组下第一个 item 的 position
resetSpan	重置	使用 GridLayoutManager 时必须调用

自定义 View 悬浮——PowerfulStickyDecoration

先创建布局item_group

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
      xmlns:android="http://schemas.android.com/apk/res/android"
      android:id="@+id/ll"
      android:orientation="horizontal"
      ...>

    <ImageView
        android:id="@+id/iv"
        .../>

    <TextView
        android:id="@+id/tv"
        .../>
</LinearLayout>

创建PowerfulStickyDecoration，实现自定View悬浮

PowerGroupListener listener = new PowerGroupListener() {
    @Override
    public String getGroupName(int position) {
        return mList.get(position).getProvince();
    }

    @Override
    public View getGroupView(int position) {
        //获取自定定义的组 View
        View view = getLayoutInflater().inflate(R.layout.item_group, null, false);
        ((TextView) view.findViewById(R.id.tv)).setText(mList.get(position).getProvince());
        return view;
    }
};
PowerfulStickyDecoration decoration = PowerfulStickyDecoration.Builder
        .init(listener)
         //重置 span（注意：使用 GridLayoutManager 时必须调用）
        //.resetSpan(mRecyclerView, (GridLayoutManager) manager)
        .build();

  ...
mRecyclerView.addItemDecoration(decoration);

效果：

支持的方法：

方法	功能	默认
setGroupHeight	高度	120px
setGroupBackground	背景色	#48BDFF
setDivideColor	分割线颜色	#CCCCCC
setDivideHeight	分割线高宽度	0
setCacheEnable	是否使用缓存	使用缓存
setHeaderCount	头部 Item 数量(仅 LinearLayoutManager)	0
setSticky	是否需要吸顶效果	true

方法	功能	描述
setOnClickListener	点击事件	设置点击事件，返回当前分组下第一个 item 的 position 以及对应的 viewId
resetSpan	重置 span	使用 GridLayoutManager 时必须调用
notifyRedraw	通知重新绘制	使用场景：网络图片加载后调用方法使用)
clearCache	清空缓存	在使用缓存的情况下，数据改变时需要清理缓存

Tips

1、若使用网络图片时，在图片加载完成后需要调用

decoration.notifyRedraw(mRv, view, position);

2、使用缓存时，若数据源改变，需要调用 clearCache 清除数据

3、点击事件穿透问题，参考 demo 中 MyRecyclerView。issue47

更新日志

----------------------------- 1.6.0 （2022-8-21）----------------------------

• fix：取消缓存无效问题
• 迁移仓库
• 迁移到 Androidx

----------------------------- 1.5.3 （2020-12-15）----------------------------

• 支持是否需要吸顶效果

----------------------------- 1.5.2 （2019-9-3）----------------------------

• fix：特殊情况下，吸顶效果不佳问题

----------------------------- 1.5.1 （2019-8-8）----------------------------

• fix：setHeaderCount 导致显示错乱问题

----------------------------- 1.5.0 （2019-6-17）----------------------------

• fix：GridLayoutManager 刷新后数据混乱问题

----------------------------- 1.4.12 （2019-5-8）----------------------------

• fix：setDivideColor 不生效问题

----------------------------- 1.4.9 （2018-10-9）----------------------------

• fix：由于添加 header 导致的一些问题

----------------------------- 1.4.8 （2018-08-26）----------------------------

• 顶部悬浮栏点击事件穿透问题：提供处理方案

----------------------------- 1.4.7 （2018-08-16）----------------------------

• fix：数据变化后，布局未刷新问题

----------------------------- 1.4.6 （2018-07-29）----------------------------

• 修改缓存方式
• 加入性能检测

----------------------------- 1.4.5 （2018-06-17）----------------------------

• 在 GridLayoutManager 中使用 setHeaderCount 方法导致布局错乱问题

----------------------------- 1.4.4 （2018-06-2）----------------------------

• 添加 setHeaderCount 方法
• 修改 README
• 修复 bug

----------------------------- 1.4.3 （2018-05-27）----------------------------

• 修复一些 bug，更改命名

----------------------------- 1.4.2 （2018-04-2）----------------------------

• 增强点击事件，现在可以得到悬浮条内 View 点击事件（没有设置 id 时，返回 View.NO_ID）

• 修复加载更多返回 null 崩溃或出现多余的悬浮 Item 问题（把加载更多放在 Item 中的加载方式）

----------------------------- 1.4.1 （2018-03-21）----------------------------

• 默认取消缓存，避免数据改变时显示出问题

• 添加 clearCache 方法用于清理缓存

----------------------------- 1.4.0 （2018-03-04）----------------------------

• 支持异步加载后的重新绘制（如网络图片加载）

• 优化缓存

• 优化 GridLayoutManager 的分割线

----------------------------- 1.3.1 （2018-01-30）----------------------------

• 修改测量方式

----------------------------- 1.3.0 （2018-01-28）----------------------------

• 删除 isAlignLeft()方法，需要靠右时，直接在布局中处理就可以了。

• 优化缓存机制。