目录 前言一、导入依赖二、适配器比较三、基础使用四、多布局和分组布局1.BaseMultiItemQuickAdapter2.BaseDelegateMultiAdapter3.BasePro
RecyclerView是Android用于取代ListView的SDK,它的灵活性和可替代性都比ListView更好,但RecyclerView也存在一些问题: 高度不能自适应、最后一个 Item 显示不全被遮挡等。而无论ListView还是RecyclerView都必不可少地会使用到适配器,其配置比较繁琐。
BaseQuickAdapter 可以对繁琐的适配器进行快速构建,相比原始的RecyclerView.Adapter适配器,能减少70%以上的代码。
本文将使用Kotlin语言来编写,Kotlin作为安卓板块的新语言,集大家之所长,一定程度上提高了开发效率,后续会有介绍。
BRVAH官方使用指南:BRVAH官方使用指南
在 build.gradle(Module:app) 的 dependencies 添加:
dependencies {implementation 'com.GitHub.CymChad:BaseRecyclerViewAdapterHelper:3.0.4'}
class RecyclerAdapter(private val context: Context, private val data: List<String>) : RecyclerView.Adapter<RecyclerView.ViewHolder>() { override fun getItemCount(): Int = data.size override fun onCreateViewHolder(parent: ViewGroup?, viewType: Int): RecyclerView.ViewHolder?{ return MyRecyclerViewHolder(LayoutInflater.from(context) .inflate(R.layout.item_recycler, parent, false)) } //override fun getItemViewType(position: Int): Int{} override fun onBindViewHolder(holder: RecyclerView.ViewHolder?, position: Int) { holder.textView.text = "" holder.textView.setOnClickListener {} } inner class MyRecyclerViewHolder(view: View) : RecyclerView.ViewHolder(view) { var textView: TextView = view.findViewById(R.id.item_tv) }}
原始的 RecyclerView.Adapter 需要编写4~5个方法:
getItemCount
2、onCreateViewHolder
3、getItemViewType
4、onBindViewHolder
5、MyRecyclerViewHolder自定义ViewHolder
class MyAdapter(private val layoutRes: Int) : BaseQuickAdapter<String, BaseViewHolder>(layoutRes) { override fun convert(holder: BaseViewHolder, item: String) { holder.setText(R.id.textView, item) }}
只需要继承BaseQuickAdapter
然后在convert方法(类似onBindViewHolder方法)中绑定数据、设置事件等,这样只需要编写一个方法即可完成大量的适配工作。
val layoutManager = LinearLayoutManager(this)recyclerView.layoutManager = layoutManagerval adapter=MyAdapter(R.layout.item_recycler)recyclerView.adapter = adapter
adapter.setNewInstance(data) //或者setNewData(),初始化数据adapter.setList(data) //更新数据
holder.getView(viewId) //获取控件holder.setText(R.id.textView, str) //设置文本holder.getView(viewId).setOnClickListener {} //指定控件的点击事件holder.getLayoutPosition() //获取当前item的position
//item整体点击事件 adapter.setOnItemClickListener { adapter, view, position -> onItemClick(view,position) } //注册item对应子控件adapter.addChildClickViewIds(R.id.item_tv) //item子控件点击事件 adapter.setOnItemChildClickListener { adapter, view, position -> onItemChildClick(view,position) }
adapter.setAnimationWithDefault(type)//默认的AnimationType类型:Alphain, ScaleIn, SlideInBottom, SlideInLeft, SlideInRight
//添加头部、尾部、空布局 val footView: View = LayoutInflater.from(this).inflate(R.layout.layout_foot, recyclerView, false) adapter.setFooterView(footView) val headView: View = LayoutInflater.from(this).inflate(R.layout.layout_head, recyclerView, false) adapter.setHeaderView(headView) val emptyView: View = LayoutInflater.from(this).inflate(R.layout.layout_empty, recyclerView, false) adapter.setEmptyView(emptyView)
//打开或关闭上拉加载adapter.setEnableLoadMore(boolean)// 滑动最后一个Item的时候回调onLoadMoreRequested方法adapter.setOnLoadMoreListener(requestLoadMoreListener)//加载完成adapter.loadMoreComplete();//加载失败adapter.loadMoreFail();//加载结束adapter.loadMoreEnd();//设置自定义加载布局adapter.setLoadMoreView(CustomLoadMoreView())//如果上拉结束后,下拉刷新需要再次开启上拉监听,需要使用setNewData方法填充数据//--------------------//打开或关闭下拉刷新adapter.setUpFetchEnable(true)//设置刷新监听adapter.setUpFetchListener(BaseQuickAdapter.UpFetchListener(){})//设置开始加载的位置adapter.setStartUpFetchPosition(2)
val adapter = ItemDragAdapter(mData) // adapter 需要继承 BaseItemDraggableAdapterval itemDragAndSwipeCallback = ItemDragAndSwipeCallback(adapter) //拖拽和删除回调val itemTouchHelper = ItemTouchHelper(itemDragAndSwipeCallback) itemTouchHelper.attachToRecyclerView(recyclerView) //绑定 recycleView// 开启拖拽adapter.enableDragitem(itemTouchHelper, R.id.item_tv, true)adapter.setOnItemDragListener(onItemDragListener) //实现 OnItemDragListener 接口// 开启滑动删除adapter.enableSwipeItem()adapter.setOnItemSwipeListener(onItemSwipeListener) //实现 OnItemSwipeListener 接口
-------------------修订内容:2023-5-15 ----------------------
最新版本已经找不到 BaseItemDraggableAdapter 类了,不知道为什么。
解决办法:第二和第三种后续会在我的博客更新如何使用,配置都比较简单的,百度也能找到
第一种办法:将版本号换成:2.9.30,但是 3.0.4 和 2.9.30 部分类包位置有改动,而且使用写法也有不同,若以前使用过,换版本的话需要对以前的代码全部进行修改
第二种办法:手动实现 RecyclerView 的 ItemTouchHelper 的回调
第三种办法:只是实现侧滑功能,可以使用第三方包:com.mcxtzhang.swipemenulib.SwipeMenuLayout
BaseSectionQuickAdapter:快速实现带头部的适配器
BaseMultiIteMQuickAdapter:适用于类型较少,业务不复杂的场景,便于快速使用
BaseDelegateMultiAdapter:数据类型任意,代理类方式,适用于实体类不方便拓展
BaseProviderMultiAdapter:数据类型任意,不限定ViewHolder类型,单独的自定义ViewHolder类,避免在convert方法中做大量的业务逻辑
数据类必须实现MultiItemEntity接口,需要给每一个数据设置itemType。
class BaseMultiQuickItem(override val itemType: Int, val data: BaseQuickerItem) : MultiItemEntity { compaNIOn object { const val FIRST_TYPE = 1 const val SECOND_TYPE = 2 }}
适配器重写getItemType方法来返回不同的数据类型。
inner class BaseQuickInfoListAdapter : BaseMultiItemQuickAdapter<BaseMultiQuickItem, BaseViewHolder>() { init { addItemType(BaseMultiQuickItem.FIRST_TYPE, R.layout.layout_first_item) addItemType(BaseMultiQuickItem.SECOND_TYPE , R.layout.layout_second_item) } override fun convert(holder: BaseViewHolder, itemMulti: BaseMultiQuickItem) { when(holder.itemViewType){ BaseMultiQuickItem.FIRST_TYPE -> { holder.setText(R.id.item_tv, "布局一") } BaseMultiQuickItem.SECOND_TYPE -> { holder.setText(R.id.item_tv, "布局二") } } }}
使用代理类的方式,返回布局id和item类型,数据类依然使用 BaseMultiQuickItem。
class DelegateMultiAdapter :BaseDelegateMultiAdapter<BaseMultiQuickItem?, BaseViewHolder>() {override fun convert(helper: BaseViewHolder, item: BaseMultiQuickItem?) { when (helper.itemViewType) { BaseMultiQuickItem.FIRST_TYPE -> helper.setText(R.id.item_tv,"布局一") BaseMultiQuickItem.SECOND_TYPE -> { when (helper.layoutPosition % 2) { 0 -> helper.setText(R.id.item_tv, "布局二 第一种") 1 -> helper.setText(R.id.item_tv, "布局二 第二种") else -> {} } } else -> {} }}init { //设置代理,通过内部类返回类型 setMultiTypeDelegate(object : BaseMultiTypeDelegate<BaseMultiQuickItem?>() { override fun getItemType(data: List<BaseMultiQuickItem?>, position: Int):Int { when (position % 3) { 0 -> return BaseMultiQuickItem.FIRST_TYPE 1 -> return BaseMultiQuickItem.SECOND_TYPE else -> {} } return 0 } }) //将类型和布局绑定 getMultiTypeDelegate() ?.addItemType(BaseMultiQuickItem.FIRST_TYPE, R.layout.layout_base_quick_first_item) ?.addItemType(BaseMultiQuickItem.SECOND_TYPE, R.layout.layout_base_quick_second_item)}}
当有多种条目时,避免在convert方法中做大量的业务逻辑,将每种Item都分离成一个个单独的类,然后整合到适配器中,最大化自定义数据类型。
class ProviderMultiAdapter : BaseProviderMultiAdapter<BaseMultiQuickItem?>() {override fun getItemType(data: List<BaseMultiQuickItem?>, position: Int): Int { when (position % 3) { 0 -> return BaseMultiQuickItem.FIRST_TYPE 1 -> return BaseMultiQuickItem.SECOND_TYPE else -> {} } return 0}init { // 注册 Provider addItemProvider(FirstItemProvider()) addItemProvider(SecondItemProvider())}}
把大量的业务逻辑抽取到了对应的ItemProvider中。
class FirstItemProvider : BaseItemProvider<BaseMultiQuickItem?>() { override val itemViewType: Int get() = BaseMultiQuickItem.FIRST_TYPE override val layoutId: Int get() = R.layout.layout_first_item //可返回自定义的 ViewHolder override fun onCreateViewHolder(parent: ViewGroup, viewType:Int): BaseViewHolder { return super.onCreateViewHolder(parent,viewType) } override fun convert(helper: BaseViewHolder, data: BaseMultiQuickItem?) { if (helper.absoluteAdapterPosition % 2 === 0) { helper.setText(R.id.item_tv, "") } else { helper.setText(R.id.item_tv, "") } } override fun onClick( helper: BaseViewHolder, view: View, data: BaseMultiQuickItem?, position: Int ) {}}
数据类需继承SectionEntity抽象类。
class BaseSectionQuickItem( override val isHeader: Boolean, bean: BaseQuickerItem) : SectionEntity<String>()
适配器:
class SectionQuickAdapter(layoutResId: Int, sectionHeadResId: Int, data: MutableList<BaseSectionQuickItem>?) :BaseSectionQuickAdapter<BaseSectionQuickItem, BaseViewHolder>(layoutResId, sectionHeadResId, data) {override fun convert(helper: BaseViewHolder, item: BaseSectionQuickItem) {}override fun convertHeader(helper: BaseViewHolder, item: BaseSectionQuickItem) {}}
BaseQuickAdapter功能强大,可以实现多布局、上拉刷新、下拉加载、侧滑删除、甚至树状列表等功能,且方便快捷,如果想要提高开发效率,适配器优先推荐使用它。这里可能介绍不全,详细的可参考官方文档。
五一假期的第一天,被迫码字和学习😭
来源地址:https://blog.csdn.net/T01151018/article/details/130431378
--结束END--
本文标题: 【Android】BaseQuickAdapter使用(RecyclerView万能适配器)
本文链接: https://www.lsjlt.com/news/460429.html(转载时请注明来源链接)
有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
下载Word文档到电脑,方便收藏和打印~
2024-01-21
2023-10-28
2023-10-28
2023-10-27
2023-10-27
2023-10-27
2023-10-27
回答
回答
回答
回答
回答
回答
回答
回答
回答
回答
0