Android：RecyclerView封装，打造列表极简加载

奋斗吧

擅长邻域：未填写

标签： Android：RecyclerView封装，打造列表极简加载 Android博客 51CTO博客

2023-07-27 18:24:12 168浏览

Android：RecyclerView封装，打造列表极简加载，此库的封装，除了刷新加载库使用了SmartRefreshLayout，其他的都是自己从0到1的开发，目前，自己已经在项目中使用，暂时没有出现任何问题，当然了，后续，也会不断的对其进行优化，增加一些其他的功能，希望有需要的小伙伴，长期关注。

前言

mBinding.recycler.linear().divider()
            .set<OrdinaryListBean> {
                addLayout(R.layout.layout_ordinary_item)
            }.setList(getList())

如果我要说，除了数据和布局之外，以上的几行代码，就实现了一个列表加载，有老铁会相信吗？

可以很负责人的告诉大家，经过Kotlin的DSL语言和扩展函数的使用，实现一个列表加载就是如此的简单，有的老铁可能会很懵，怎么没有看到适配器啊，也没有看到设置布局管理器啊，这就是此次封装的隐秘之处，弱化adapter的存在，当然了只是使用上弱化，其内部依然用到了adapter。

经过代码上不断的完善，功能上不断的拓展，目前的封装，已经满足绝大部分的常见需求，决定开源出来，希望可以给RecyclerView的使用上，带来一丝变化，当然了，此项目也会不定期更新，也欢迎大家在使用上提出自己的见解和问题，也希望点个小星星。

目前已开发功能：

Android：RecyclerView封装，打造列表极简加载_Android列表拖拽排序

本篇文章的概述如下

1、封装库快速使用

2、具体功能一一概述

3、开源地址

4、使用总结

5、后续规划

一、封装库快速使用

目前封装的库，已经上传到远程Maven，大家可以按照如下的步骤进行使用：

1、在你的根项目下的build.gradle文件下，引入maven。

allprojects {
    repositories {
        maven { url "https://gitee.com/AbnerAndroid/almighty/raw/master" }
    }
}

2、在你需要使用的Module中build.gradle文件下，引入依赖。

dependencies {
    implementation 'com.vip:relist:1.0.5'//一个包含了列表加载和下拉刷新、上拉加载的库，它包含了下面的两个库，使用它，下面的两个就不要引用了。
    implementation 'com.vip:list:1.0.4'//列表加载库，如果使用了relist，这个不要再引用
    implementation 'com.vip:refresh:1.0.0'//下拉刷新、上拉加载库，如果使用了relist，这个不要再引用
}

需要注意的是，目前拆分了三个依赖，大家一定看清楚后，进行选择使用。refresh依赖只是对SmartRefreshLayout包了一层，没有做过多的扩展，如果大家项目中已经有了刷新库，其实只用list这个依赖即可。list库是纯RecyclerView封装库，没有用到任何的第三方，大家可以放心使用。

依赖	概述	版本号	集成
relist	一个包含了列表加载和下拉刷新、上拉加载的库	1.0.5	implementation 'com.vip:relist:1.0.5'
list	只包含列表加载（添加头尾、缺省页、侧滑删除、吸顶效果、分割线、DataBinding等）	1.0.4	implementation 'com.vip:list:1.0.4'
refresh	只包含下拉刷新、上拉加载	1.0.0	implementation 'com.vip:refresh:1.0.0'

二、具体功能使用

关于功能上的使用，大家可以直接看源码，或者访问github地址后看使用说明也可以，当然了，在这里我也罗列一下。

1、普通的列表加载

普通的列表加载，就是RecyclerView原始的用法，创建适配器Adapter，给RecyclerView设置布局管理器，给RecyclerView设置适配器，虽然说，Adapter已经抽取封装了，但考虑到还有一部分小伙伴具有怀旧意识，也很喜欢使用这种方式加载列表，于是呢，这种方式就保留了。

具体使用，举例如下：

创建适配器

即便是普通列表加载，这里也是建议继承父类BaseAdapter，因为直接继承RecyclerView.Adapter的方式，还得要重写一大堆方法，实在是冗余。

BaseAdapter对RecyclerView.Adapter做了一层封装，只需要传递要加载的layout和数据对象泛型即可，这两个就不贴源码了，一个是xml布局，一个自己定义的对象，没啥好说的。

数据绑定和逻辑处理，实现dataOperation方法即可，当然，这个也是强制要实现的方法。

class OrdinaryListAdapter : BaseAdapter<OrdinaryListBean>(R.layout.layout_ordinary_item) {

    override fun dataOperation(holder: BaseViewHolder, t: OrdinaryListBean?, position: Int) {

        t?.title?.let {
            holder.setText(R.id.tv_title, it)
        }

        t?.desc?.let {
            holder.setText(R.id.tv_desc, it)
        }

        val ivPic = holder.findView<ImageView>(R.id.iv_pic)

        t?.icon?.let {
            ivPic.setImageResource(it)
        }


    }
}

设置布局管理器和适配器

这些代码就比较熟悉了吧，都是RecyclerView的原始用法，点击事件调用adapter中的setOnItemClickListener方法即可。

因为使用了ViewDataBinding，这里的mBinding.recycler指的是RecyclerView控件。

val manger = LinearLayoutManager(requireContext())
        manger.orientation = LinearLayoutManager.VERTICAL
        //设置布局管理器
        mBinding.recycler.layoutManager = manger

        val adapter = OrdinaryListAdapter()
        //设置适配器
        mBinding.recycler.adapter = adapter

        //设置分割线
        mBinding.recycler.addItemDecoration(
            ItemDivider(
                Color.parseColor("#cccccc"),
                RecyclerView.VERTICAL, 0
            )
        )

        //设置数据
        adapter.setList(getList())

        adapter.setOnItemClickListener {
            //条目点击事件
            Toast.makeText(requireContext(), "当前点击条目为：$it", Toast.LENGTH_SHORT).show()
        }

简化设置布局管理器和适配器

看到上面的代码，还是觉得有些冗余，普通列表加载，也是建议大家尽量使用简洁用法。

val adapter = OrdinaryListAdapter()

  mBinding.recycler.linear()//设置布局管理器
            .divider()//设置分割线
            .adapter=adapter//设置适配器

       //设置数据
        adapter.setList(getList())

        adapter.setOnItemClickListener {
            //条目点击事件
            Toast.makeText(requireContext(), "当前点击条目为：$it", Toast.LENGTH_SHORT).show()
        }

布局管理器调用如下：

垂直列表：linear()
横向列表：linear(RecyclerView.HORIZONTAL)
网格列表：grid(2)，一列展示几个，传递数值即可
瀑布流列表：staggered(2)，一列展示几个，传递数值即可

至于其他的列表展示，如，网格和瀑布流形式，只需要更改布局管理器即可。

2、封装之后的列表加载

封装之后的列表加载，是推荐使用的，相对于普通的列表加载，完全弱化了适配器的存在，只需要考虑数据处理即可，非常的简单。

mBinding.recycler.linear()
            .divider()
            .set<OrdinaryListBean> {
                addLayout(R.layout.layout_ordinary_item)
                bindData {
                    //获取DataBinding
                    val binding = getDataBinding<LayoutOrdinaryItemBinding>()
                    //获取Model
                    val model = getModel(adapterPosition)
                    binding?.apply {
                        tvTitle.text = model.title
                        tvDesc.text = model.desc
                        ivPic.setImageResource(model.icon!!)
                    }
                    setOnItemClickListener {
                        //条目点击事件
                        Toast.makeText(requireContext(), "当前点击条目为：$it", Toast.LENGTH_SHORT)
                            .show()
                    }
                }

            }.setList(getList())

相关方法说明：

属性或方法	概述
mBinding.recycler	因为使用了ViewDataBinding，这里的mBinding.recycler指的是RecyclerView 控件。
linear	布局管理器，可调用方法如下：垂直列表：linear() 横向列表：linear(RecyclerView.HORIZONTAL) 网格列表：grid(2)，一列展示几个，传递数值即可瀑布流列表：staggered(2)，一列展示几个，传递数值即可
divider	分割线
set	扩展函数，泛型为加载的对象
addLayout	添加列表Item展示的布局
bindData	绑定数据和处理逻辑
getDataBinding	获取ViewDataBinding
getModel	获取数据对象
setOnItemClickListener	条目点击事件
setList	设置列表数据

有的老铁可能会问了，封装之后简单是简单了，但是如果遇到复杂列表，都写到一个类里，代码量实在是太多了，哎！这确实是个问题，但是呢，又不是问题，如果bindData里的逻辑比较多，你完成可以抽取到其他地方，比如ViewModel里，在ViewModel定义方法后，调用即可，又或者呢，使用后边的DataBinding。

3、多条目列表加载

Android：RecyclerView封装，打造列表极简加载_Android列表拖拽排序_02

效果图可以忽略，重在功能哈~，多条目加载也封装了，有适配器和无适配方式，在实际的业务开发中，大家可以选择性进行使用。

有适配器模式

也就是和传统的多条目保持一致，都在适配器里进行数据的渲染和逻辑处理。

还是那句话，多条目的适配器也抽取了基类，既然都有基类了，为了代码上的简洁，建议还是继承基类比较好。

如何添加多条目？

直接在构造方法里，调用addLayout即可，有几个多条目就添加几个，是不是非常的方便，泛型为数据对象，参数为多条目xml布局。

如何数据渲染和逻辑处理？

实现bindOperation方法即可，通过holder.itemViewType来却分多条目的类型，当然了这个必须和数据对象里的类型保持一致。

区分多条目类型

数据对象实现BaseMultipleItem，重写itemViewType属性，itemViewType就是用来区分多条目类型的，可以随意设置，或者是接口的某个参数，或者是对应的layout。

class OrdinaryMultipleItemAdapter : BaseMultipleItemAdapter {

    constructor() {
        //添加多条目类型以及绑定的数据对象
        addLayout<MultipleItem01Bean>(R.layout.layout_ordinary_multiple_01)
        addLayout<MultipleItem02Bean>(R.layout.layout_ordinary_multiple_02)
        addLayout<MultipleItem03Bean>(R.layout.layout_ordinary_multiple_03)
    }

    override fun bindOperation(holder: BaseViewHolder, t: BaseMultipleItem?, position: Int) {

        when (holder.itemViewType) {
            1 -> {
                val bean = t as MultipleItem01Bean
                holder.setText(R.id.tv_title, bean.title!!)
                holder.setText(R.id.tv_desc, bean.desc!!)
                val ivPic = holder.findView<ImageView>(R.id.iv_pic)
                ivPic.setImageDrawable(bean.icon)
            }
            2 -> {
                val bean = t as MultipleItem02Bean
                val ivPic01 = holder.findView<ImageView>(R.id.iv_01)
                val ivPic02 = holder.findView<ImageView>(R.id.iv_02)
                val ivPic03 = holder.findView<ImageView>(R.id.iv_03)

                ivPic01.setImageDrawable(bean.icon01)
                ivPic02.setImageDrawable(bean.icon02)
                ivPic03.setImageDrawable(bean.icon03)
            }
            3 -> {
                val bean = t as MultipleItem03Bean
                holder.setText(R.id.tv_content, bean.content!!)
            }
        }
    }

}

设置布局管理器和适配器

val adapter = OrdinaryMultipleItemAdapter()
        mBinding.recycler.linear()
            .divider().adapter = adapter
        adapter.setList(getMoreList())

无适配器模式

无适配器模式，更加的简单，只需要调用setMore方法即可，有多少条目就调用addLayout几次，在bindData里进行数据渲染和逻辑处理，当然了，也可以使用DataBinding形式，需要追加BR。

mBinding.recycler.linear()
            .divider()
            .setMore {
                addLayout<MultipleItem01Bean>(R.layout.layout_multiple_01, BR.multiple1)
                addLayout<MultipleItem02Bean>(R.layout.layout_multiple_02, BR.multiple2)
                addLayout<MultipleItem03Bean>(R.layout.layout_multiple_03, BR.multiple3)
                bindData {

                }
            }.setList(getMoreList())

4、DataBinding形式列表加载

Android：RecyclerView封装，打造列表极简加载_Android列表加载_03

DataBinding的出现，使得数据绑定更加的简单化，大大减少了代码的书写，大家可以采用提供的两种方式进行使用，一种是针对Item的绑定，一种是对RecyclerView自身的绑定。

Item绑定

第一步，addLayout，增加和xml绑定的BR

mBinding.recycler.linear().divider()
            .set<OrdinaryListBean> {
                addLayout(R.layout.layout_ordinary_bind_item, BR.ordinary)
                setOnItemViewClickListener { view, position ->
                    //条目点击事件
                    Toast.makeText(requireContext(), "当前点击条目为：$position", Toast.LENGTH_SHORT).show()
                }
            }.setList(getList())

第二步，xml数据绑定

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <data>

        <variable
            name="ordinary"
            type="com.abner.list.ordinary.OrdinaryListBean" />
    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="@dimen/vip_dp_80"
        android:paddingLeft="@dimen/vip_dp_20"
        android:paddingRight="@dimen/vip_dp_20">

        <ImageView
            android:id="@+id/iv_pic"
            android:layout_width="@dimen/vip_dp_60"
            android:layout_height="@dimen/vip_dp_60"
            android:src="@mipmap/vip_list_logo"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

        <LinearLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginStart="@dimen/vip_dp_10"
            android:orientation="vertical"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toRightOf="@id/iv_pic"
            app:layout_constraintTop_toTopOf="parent">

            <TextView
                android:id="@+id/tv_title"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="@{ordinary.title}"
                android:textColor="#222222"
                android:textSize="@dimen/vip_sp_16" />

            <TextView
                android:id="@+id/tv_desc"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_marginTop="@dimen/vip_dp_10"
                android:text="@{ordinary.desc}"
                android:textColor="#666666"
                android:textSize="@dimen/vip_sp_14" />

        </LinearLayout>

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

RecyclerView绑定

第一步，xml中RecyclerView数据绑定

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="model"
            type="com.abner.list.bind.RecyclerViewBindViewModel" />
    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <androidx.recyclerview.widget.RecyclerView
            android:id="@+id/recycler"
            listData="@{model.list}"
            listLayout="@{model.layoutId}"
            listManager="@{0}"
            listVariableName="@{model.listVariableName}"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

第二步、对应model中提供数据

class RecyclerViewBindViewModel : BaseViewModel() {

    val layoutId = R.layout.layout_ordinary_bind_item//item列表

    /**
     * AUTHOR:AbnerMing
     * INTRODUCE:获取视图绑定的name
     */
    fun getListVariableName(): Int {
        return BR.ordinary
    }

    /**
     * AUTHOR:AbnerMing
     * INTRODUCE:模拟数据
     */
    fun getList(): MutableList<OrdinaryListBean> {

        return mutableListOf<OrdinaryListBean>().apply {
            for (a in 0..20) {
                val bean = OrdinaryListBean()
                bean.title = "我是标题$a"
                bean.desc = "我是描述信息$a"
                bean.icon = R.mipmap.vip_list_logo
                add(bean)
            }
        }
    }
}

属性一览

属性	类型	概述
listManager	Int	布局管理器：默认为纵向的普通列表。 0：普通列表 1：网格 2：瀑布流
listOrientation	Int	设置列表方向，默认纵向。横向：RecyclerView.HORIZONTAL
listSpanCount	Int	展示几列，适用于网格和瀑布流
isDivider	Boolean	是否展示分割线
dividerDrawable	Int	分割线样式
listLayout	Int	Item布局
listData	MutableList<T>	数据
listVariableName	Int	绑定的BR
listAdapter	OnAdapterListener<T>	返回适配器，可以通过这里实现，适配器中的逻辑处理
isMultiple	Boolean	是否是多条目
multipleAdapter	OnAdapterMultipleListener	返回多条目适配器
multipleData	MutableList<BaseMultipleItem>	多条目数据
multipleLayout	MutableList<Int>	多条目布局
multipleLayoutBindData	MutableList<Class<*>>	layout绑定的数据对象
multipleVariableName	MutableList<Int>	xml绑定的对应的VariableName

两种绑定方式，各有优点，大家可以根据实际的业务进行选择使用。

5、设置分割线

Android：RecyclerView封装，打造列表极简加载_Android列表侧滑删除_04

调用divider方法即可。

mBinding.recycler.linear()
            .divider()
            .set<OrdinaryListBean> {
                addLayout(R.layout.layout_ordinary_bind_item, BR.ordinary)
            }.setList(getList())

divider可选参数如下：

参数	类型	概述
color	Int	分割线颜色，默认是#cccccc
orientation	Int	分割线方向，默认和纵向保持一致，RecyclerView.VERTICAL
lineWidth	Int	分割线的高度
margin	Int	分割线距离左右或者距离上下的边距
hideLast	Boolean	是否隐藏最后一条分割线
itemType	Int	默认为0，不为0时，则绘制横向线条，适用于网格列表分割线

6、头和尾追加和删除

头和尾的添加支持layout和View两种添加方式，代码如下所示：

mAdapter?.addHead(R.layout.layout_head)//初始 添加头  不用刷新
mAdapter?.addFoot(R.layout.layout_foot)//初始 添加尾  不用刷新

后续如果动态添加头尾，需要更新适配器。

mAdapter?.addHead(view, true)//追加头，需要刷新
 mAdapter?.addFoot(view, true)//追加尾，需要刷新

动态删除头尾操作，支持按照索引进行删除。

mAdapter?.removeHead()
mAdapter?.removeFooter()

7、数据追加和删除

初始添加数据

//
mAdapter?.setList(getList())

追加数据，支持对象和集合两种方式

mAdapter?.addData()

删除数据

mAdapter?.removeData(0)

8、设置缺省页面

缺省页面没什么好说的，数据为空或者数据加载错误的时候，设置一张占位View。

空页面，调用addEmptyView即可，支持layout和View两种模式，错误页面，调用addErrorView，和空页面使用方式一致。

mAdapter = mBinding.recycler.linear()
            .divider()
            .set {
                addEmptyView(R.layout.layout_empty)//初始化 空页面
                addErrorView(R.layout.layout_error)//初始化  错误页面
                addLayout(R.layout.layout_item, BR.str)
            }

        //初始添加数据
        mAdapter?.setList(getList())

功能	实现
显示空	mAdapter?.showEmptyView()
隐藏空	mAdapter?.hintEmptyView()
显示错误	mAdapter?.showErrorView()
隐藏错误	mAdapter?.hintErrorView()

9、拖拽排序功能

Android：RecyclerView封装，打造列表极简加载_Android列表添加头_05

调用drag方法即可实现拖拽排序功能。

mBinding.recycler.linear()
            .drag()//支持拖拽
            .set<DragBean> {
                addLayout(R.layout.layout_drag_item, BR.drag)
            }.setList(getList())

注意事项

传递的数据对象必须实现BaseNoDragBean，需要重写isDrag属性，false为禁止拖拽，true为允许拖拽。

class DragBean : BaseNoDragBean {
    override var isDrag = false

    var content = ""

}

10、侧滑删除条目

调用slideDelete方法即可，支持左右侧滑删除，传递不同的值即可。

mBinding.recycler
            .linear()
            .slideDelete()//支持侧滑删除 默认是左滑删除 0是右边  1是左右两边
            .set<String> {
                addLayout(R.layout.layout_main_item, BR.str)
            }.setList(getList())

11、侧滑显示按钮

Android：RecyclerView封装，打造列表极简加载_Android列表加载_06

由原来的set方法改为setSlide方法即可。

mBinding.recycler
            .linear()
            .divider()
            .setSlide<String> {//如果要显示按钮 使用 setSlide
                addLayout(R.layout.layout_item)
                bindData {
                    val model = getModel(adapterPosition)
                    setText(R.id.tv_content, model)
                }
            }.setList(getList())

有的老铁可能会问，我想展示多个按钮，或者展示自定义的View，如何实现呢？在setSlide调用addSlideLayout，传入自己的xml布局即可。

12、条目吸顶功能

Android：RecyclerView封装，打造列表极简加载_Android列表加载_07

实现吸顶就调用stick方法即可。

mBinding.recycler.linear()
            .stick()
            .set<StickHeaderBean> {
                addLayout(R.layout.layout_stick_item, BR.stick)
            }.setList(getList())

需要注意，数据对象需要实现StickHeaderBean，重写分组标识。

class StickHeaderBean : BaseStickHeaderBean {

    override var stickGroup: String = ""//分组标识

    var name = ""//普通内容
}

13、单选、多选、全选、反选

当然了这都是业务层的逻辑，按理来说，没必要在封装，但是考虑到代码的简洁性，单选和多选的判断逻辑就封装了一下，大家如有用到此功能，可按照如下的方式进行操作即可。

单选

主要的就两部分：

1、开启单选刷新

mNotifySingleChoice = true

2、判断单选

adapterPosition == mCheckPosition，可以利用mCheckPosition来判断，进而更新UI。

mBinding.recycler.linear().divider().set<SingleBean> {
            mNotifySingleChoice = true//开启单选刷新
            addLayout(R.layout.layout_single_choice_list_item, BR.single)
            bindData {
                val binding = this.getDataBinding<LayoutSingleChoiceListItemBinding>()
                //判断单选，直接判断  adapterPosition == mCheckPosition 即可
                binding?.checkbox?.isChecked = adapterPosition == mCheckPosition
                setOnItemViewClickListener { view, position ->
                    //条目点击
                    val singleBean = getList()[position]//单选 选择的对象
                    mViewModel.name.set(singleBean.name)
                }
            }
        }.setList(getList())

多选

和单选一样，也是两部分

1、设置多选更新

mNotifyMultipleChoice = true

2、多选回调监听

setOnMultipleChoiceListener{}

mBinding.recycler.linear().divider().set<MultipleBean> {
            mNotifyMultipleChoice = true//多选更新
            addLayout(R.layout.layout_multiple_choice_list_item, BR.multiple)
            bindData {
                //多选回调监听
                setOnMultipleChoiceListener {
                    var allPrice = 0.0f
                    it.forEach {
                        allPrice += it.price
                    }
                    mViewModel.commodityNumber.set("选择商品数量为：" + it.size)
                    mViewModel.allPrice.set("总价格为：$allPrice")
                }
            }
        }.setList(getList())

14、上拉刷新和下拉加载

Android：RecyclerView封装，打造列表极简加载_Android列表侧滑删除_08

刷新和加载使用的是SmartRefreshLayout这个开源框架，毕竟已经有很优秀的框架了，没必要再重新封装一个，具体的用法，大家可以按照SmartRefreshLayout的文档去操作使用就行。

支持全局设置下拉和上拉展示View，只需要在Application里初始化即可。

//上拉加载和下拉刷新，初始化头和尾
        ListConfig.apply {
            addRefreshHeader {
                ClassicsHeader(it)
            }
            addRefreshFooter {
                ClassicsFooter(it)
            }
        }

这里也简单举个例子：

1、xml中引入

<com.abner.refresh.kernel.SmartRefreshLayout
        android:id="@+id/srl_layout"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <androidx.recyclerview.widget.RecyclerView
            android:id="@+id/rv_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />
    </com.abner.refresh.kernel.SmartRefreshLayout>

2、代码简单使用

mSmartRefreshLayout?.setOnRefreshLoadMoreListener(object : OnRefreshLoadMoreListener {
            override fun onRefresh(refreshLayout: RefreshLayout) {
               
            }

            override fun onLoadMore(refreshLayout: RefreshLayout) {
             
            }
        })

当然了，为了更好的拓展使用，针对SmartRefreshLayout，又简单做了一层包装，别无他意，就是为了让使用更加的简单。

1、xml里引入PageRefreshLayout

<com.abner.relist.PageRefreshLayout
            android:id="@+id/refresh"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />

2、代码里使用

mBinding.refresh.getRecycler().linear()
            .divider()
            .set<String> {
                addLayout(R.layout.layout_item, BR.str)
            }
        //刷新和加载
        mBinding.refresh.refresh { isRefresh, refreshLayout ->
            mViewModel.doHttp {
                addData(it)
            }
        }.autoRefresh()

直接调用refresh方法即可，isRefresh为true是下拉，否则就是上拉，非常的方便，而addData方法，则实现了分页加载数据，上拉和下拉直接调用addData即可。

PageRefreshLayout可调用方法如下

方法	参数	概述
autoRefresh	无参	自动刷新操作
refresh	无参	静默刷新（不带下拉刷新动画）
addData	Collection<T>	添加数据，分页会自动追加数据，下拉和上拉会自动关闭
setEnableRefresh	Boolean	是否禁止下拉
setEnableLoadMore	Boolean	是否禁止上拉
finishRefresh	无参	关闭下拉刷新
finishLoadMore	无参	关闭上拉刷新
getPager	无参	获取当前页码
refresh	回调函数	刷新和加载方法
getSmartRefresh	无参	获取SmartRefreshLayout
getRecycler	无参	获取RecyclerView
addEmptyView	Int/View	添加空的布局，支持layout和View
addErrorView	Int/View	添加错误的布局，支持layout和View
showEmptyView	无参	显示空布局
showErrorView	无参	显示错误布局
hintEmptyView	无参	隐藏空布局
hintErrorView	无参	隐藏错误布局
setHeightWrapContent	无参	设置整体的列表由充满改为包裹内容。

三、开源地址

关于大家在使用上的问题以及后续的优化，或者功能新增，都会时长更新，方便的话，给个小星星呗~

开源地址：https://github.com/AbnerMing888/VipList

四、使用总结

1、无适配器的模式，在逻辑相对复杂的页面，建议大家可以抽取到ViewModel中实现，当然，也可以采用DataBinding的形式。

2、很多使用方式，或者常见的业务开发场景，在文档中或者源码中，都会详细的备注，大家可以细心的查看即可。

3、条目点击事件，给出了两个，大家可以选择性使用。

只返回索引

setOnItemClickListener { 
                    
}

当前点击的View和索引。

setOnItemViewClickListener { view, position ->
                   
 }

五、后续规划

此库的封装，除了刷新加载库使用了SmartRefreshLayout，其他的都是自己从0到1的开发，目前，自己已经在项目中使用，暂时没有出现任何问题，当然了，后续，也会不断的对其进行优化，增加一些其他的功能，希望有需要的小伙伴，长期关注。

关于维护上，不断的优化和解决一些大家所提的问题。

关于源码上，后续会逐一剖析其实现方式，确确实实，里面用到了一些另类技术，当然了，这都是后话了。

好博客就要一起分享哦！分享海报

此处可发布评论

评论（0）展开评论

暂无评论，快来写一下吧

展开评论

您可能感兴趣的博客

141万+ 人气	865 博客	0 专栏
问答	1 粉丝	0 关注

写博客博客管理

他感兴趣的技术

Java HTML PHP python JavaScript Android MySQL C Linux 微信其他

最热博客更多

1、黑客入侵的常法 4551

2、黑马Mysql从入门到高级 1883

3、Windows怎么激活？Windows激活密钥分享 1877

4、类ChatGPT项目的部署与微调(上)：从LLaMA到Alpaca、Vicuna、BELLE 1867

5、掌握Conda环境迁移的几种方式，从此不在重复配环境 1662

6、分享200+个关于AI的网站 1568

7、小迪笔记 1543

8、Yolov8详解与实战 1262

9、JavaScript/jQuery、HTML、CSS 构建 Web IM 远程及时聊天通信程序 897

10、webpack构建React、TSX项目（一） 844