Skip to content
mumu edited this page May 11, 2023 · 65 revisions

本文档仅针对 4.x 版本

3.x → 4.x 是不兼容升级


前言

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

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

Demo

Google云盘

国内云盘


开始

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

一句话引入本库

implementation "io.github.cymchad:BaseRecyclerViewAdapterHelper:4.0.0-beta10"

Adapter 类型

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

BaseQuickAdapter

多类型布局 Adapter

BaseMultiItemAdapter

Differ Adapter

BaseDifferAdapter

只有单个 item 情况下的 Adapter

BaseSingleItemAdapter

多类型 Adapter 组合(包含“加载更多”)

QuickAdapterHelper

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

加载更多

加载状态的父类

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

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

默认样式的实现

DefaultLeadingLoadStateAdapter

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

默认样式的实现

DefaultTrailingLoadStateAdapter


ViewHolder 类型

QuickViewHolder

快速使用的 ViewHolder 类

DataBindingHolder

ViewDataBinding 的便捷类