Skip to content
mumu edited this page Sep 8, 2025 · 77 revisions

本文档仅针对 4.x 版本


前言

4.x 完善了多项升级,遵照Kotlin First,彻底的重构解决了多项问题,带来了更稳定的功能:

  • “向下加载更多”的代码更加简洁,解决了加载卡顿问题
  • “向上加载”获得了与“向下加载更多”同样的代码等级,“向上加载”现在更加完整
  • BaseQuickAdapter支持了ConcatAdapter,不会因为ItemType被重写而导致的错误
  • 更加解耦的代码设计,通过ConcatAdapter来组合不同类型,例如:“加载更多”、头部、尾部
  • 完整的Differ支持
  • 规范的API命名

Demo

Google云盘

国内云盘


开始

从v4开始,本库将会上传至maven中央仓库,不需要再添加三方仓库配置了。

一句话引入本库

implementation("io.github.cymchad:BaseRecyclerViewAdapterHelper4:4.2.0")

Adapter 类型(暂无 BaseNoteAdapter)

基础类型 Adapter(包含点击事件、数据操作、动画、空视图)

BaseQuickAdapter

多类型布局 Adapter

BaseMultiItemAdapter

~~### Differ Adapter(已过期)~~ ~~BaseDifferAdapter~~

树形节点展开的 Adapter

BaseNodeAdapter

只有单个 item 情况下的 Adapter

BaseSingleItemAdapter

多类型 Adapter 组合(包含“加载更多”、“头部”、“尾部”)

QuickAdapterHelper

内部通过ConcatAdapter组合各类型Adapter,其中包括实现“加载更多”功能

加载更多

加载状态的父类

LoadStateAdapter "加载更多"、"向上加载"都继承于此

LeadingLoadStateAdapter 可继承此类,实现自定义样式

默认样式的实现

DefaultLeadingLoadStateAdapter

TrailingLoadStateAdapter 可继承此类,实现自定义样式

默认样式的实现

DefaultTrailingLoadStateAdapter


ViewHolder 类型

QuickViewHolder

快速使用的 ViewHolder 类

DataBindingHolder

ViewDataBinding 的便捷类


Clone this wiki locally