Android中快速为Recyclerview添加头部

心已赠人 2023-02-12 11:29 703阅读 0赞

为Android RecyclerView添加头部。

调用简单的代码就可以为LinearLayoutManager，GridLayoutManager ，StaggeredGridLayoutManager布局的RecyclerView添加header。

## 运行效果： ##

![超快和轻松为RecyclerView添加头部：RecyclerViewHeader][RecyclerView_RecyclerViewHeader]

## 使用说明： ##

有两种使用RecyclerViewHeader的方法：

方法1

(使用起来非常简单，但是它会添加额外的布局，因此效率略低于第二种方法):

为header创建一个xml布局（可以包括任意view或者ViewGroup）

使用静态初始方法从xml中创建RecyclerViewHeader

RecyclerViewHeader header = RecyclerViewHeader.fromXml(context, R.layout.header);

将RecyclerViewHeader Attach 到RecyclerView，搞定！

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
    // set LayoutManager for your RecyclerView
    header.attachTo(recyclerView);

**方法2**

Header-already-aligned approach (不会引入任何额外布局):

将RecyclerViewHeader布局放在RecyclerView的上层。

获得RecyclerViewHeader对象：

RecyclerViewHeader header = (RecyclerViewHeader) findViewById(R.id.header);

把RecyclerViewHeader赋予RecyclerView

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
    
    header.attachTo(recyclerView, true);

## 注意事项 ##

RecyclerViewHeader必须在RecyclerView设置了LayoutManager之后调用。

目前该库适用于LinearLayoutManager,GridLayoutManager和StaggeredGridLayoutManager布局的RecyclerViews。

只支持垂直布局LayoutManager

如果你打算在RecyclerView中使用setOnScrollListener(...)方法，确保在setOnScrollListener(...)的attachTo(...)方法之前使用。

## 导入项目 ##

build.gradle

dependencies {
        compile 'com.bartoszlipinski.recyclerviewheader:library:1.2.0'
    }

[RecyclerView_RecyclerViewHeader]: https://imgconvert.csdnimg.cn/aHR0cDovL3N0YXRpYy5vcGVuLW9wZW4uY29tL2xpYi91cGxvYWRJbWcvMjAxNTA2MTYvMjAxNTA2MTYxMDQyNDhfMjU0LnBuZw?x-oss-process=image/format,png