
Adapter 的使用 1
BaseRecyclerViewAdapterHelper
说明
1、BaseQuickAdapter<T, VH>为最基本的类型,提供最基础的功能,所有子类都继承于此。
2、T为数据类型;VH为ViewHolder类型,如果不需要自定义,直接使用BaseViewHolder即可。
3、框架提供了一个基础BaseViewHolder,所有自定义的ViewHolder都应该继承于此!
BaseQuickAdapter<T, VH>
1、快速使用
BaseQuickAdapter<T, VH>为最基础的类型,直接使用BaseQuickAdapter<T, VH>即可简单快速实现一个Adapter:
Activity中设置:
2、纯View创建Item
如果不想使用xml布局,想直接使用View代码方式创建,那么构造函数使用super(0),并且在Adapter中重写onCreateDefViewHolder方法:
3、BaseQuickAdapter 点击事件
Item 点击事件
代码如下:
Item 长按事件
代码如下:
Item 内子View的点击事件:
注意,请不要在convert方法里注册控件id
Item 内子View的长按事件:
注意,请不要在convert方法里注册控件id
4、BaseQuickAdapter主要属性、方法说明
Java | Kotlin | 说明 | |
获取Context | getContext() | context | |
数据相关 | |||
获取Adapter中数据 | getData() | data | 只能get |
设置新的数据实例 | setNewData() | setNewData() | 将会替换List指针引用 |
添加数据 | addData() | addData() | |
移除数据 | remove() | remove() | |
改变某一位置的数据 | setData() | setData() | |
替换整个数据 | replaceData() | replaceData() | 不会更改原数据的引用 |
设置Diff数据(异步,推荐) | setDiffCallback() | setDiffCallback() | 配置数据差异化比较的Callback |
setDiffConfig() | setDiffConfig() | 更高程度的自定义化配置 | |
setDiffNewData(List) | setDiffNewData(List?) | 必须先设置setDiffCallback() 或者 setDiffConfig(),否则不生效 | |
设置Diff数据 | setDiffNewData(DiffResult, List) | setDiffNewData(DiffResult, List?) | 通过DiffResult设置数据,Adapter内部不关心Diff过程,只要结果。 |
空布局 | 仅当 data 为空时,才会显示 | ||
设置空布局视图 | setEmptyView() | setEmptyView() | |
是否有空视图 | hasEmptyView() | hasEmptyView() | |
获取空视图 | getEmptyLayout() | getEmptyLayout() | |
是否使用空布局 | setUseEmpty() | isUseEmpty | |
头布局 | |||
添加头布局 | addHeaderView() | addHeaderView() | |
设置头布局 | setHeaderView() | setHeaderView() | |
是否有头布局 | hasHeaderLayout() | hasHeaderLayout() | |
移除头布局 | removeHeaderView() | removeHeaderView() | |
移除所有头布局 | removeAllHeaderView() | removeAllHeaderView() | |
脚布局 | |||
添加脚布局 | addFooterView() | addFooterView() | |
设置脚布局 | setFooterView() | setFooterView() | |
是否有脚布局 | hasFooterLayout() | hasFooterLayout() | |
移除脚布局 | removeFooterView() | removeFooterView() | |
移除所有脚布局 | removeAllFooterView() | removeAllFooterView() | |
布局其他属性 | |||
当显示空布局时,是否显示 头布局 | setHeaderWithEmptyEnable() | headerWithEmptyEnable | |
当显示空布局时,是否显示 脚布局 | setFooterWithEmptyEnable() | footerWithEmptyEnable | |
点击事件 | |||
item点击事件 | setOnItemClickListener() | 同java | |
item长按事件 | setOnItemLongClickListener | 同java | |
item子view的点击事件 | setOnItemChildClickListener | 同java | |
item子view的长按事件 | setOnItemChildLongClickListener | 同java | |
添加需要响应点击事件的子View id | addChildClickViewIds() | 同java | 添加以后,setOnItemChildClickListener才会响应 |
添加需要响应长按事件的子View id | getChildLongClickViewIds() | 同java | |
动画 | |||
是否打开动画 | setAnimationEnable() | animationEnable | 默认:false |
动画是否仅第一次执行 | setAnimationFirstOnly() | isAnimationFirstOnly | |
设置自定义动画 | setAdapterAnimation() | adapterAnimation | |
设置使用内置默认动画 | setAnimationWithDefault() | setAnimationWithDefault() | 参数为枚举 |
、
BaseQuickAdapter 空布局\头部\脚部
1、空布局
说明:当adapter中数据不为空时,空布局不会生效
通过设置View为空布局
代码如下:
通过设置LayoutResId为空布局
代码如下:
设置是否使用空布局(默认为true)
代码如下:
2、头部
说明:此头部并不是item的头部,而是整个Adapter的头部
代码如下:
3、脚部
说明:此脚部不是item的脚部,而是整个Adapter的
代码如下:
DataBinding
基于 BaseQuickAdapter 的用法:
代码如下:
基于 BaseProviderMultiAdapter 的用法
由于使用了Provider,所以相关事务并不在Adapter里处理。需要在Provider中对数据进行绑定。
Adapter代码如下(无需特殊处理,和普通的BaseProviderMultiAdapter写法一样):
Provider代码如下:
‘
