一、BaseQuickAdapter 简介
-
减少重复 Adapter 代码
-
添加 Item 的点击事件,长按事件以及子控件的点击事件
-
添加头部、尾部,下拉刷新、上拉加载(上拉加载的5种加载更多动画任你选择,后期会添加更多的加载动画)、没有更多数据
-
可以自定义头部、尾部、加载更多布局
-
添加 Item滑动动画 (9种动画切换,轻松一行代码)
-
添加新增、删除 Item动画 (目前支持默认的动画方式)
-
网格,列表,流式随意切换
-
添加空布局(列表无数据时,显示更加人性化)
-
拖拽和侧滑删除
-
支持多类型布局
-
类似淘宝列表切换
-
字母导航
-
类似探探翻牌
看了 BaseQuickAdapter 的特性,接着来看看外面如何在项目中导入(依赖)它。
BaseQuickAdapter 导入(依赖)
方式一:build.gradle 的 dependencies 添加如下代码:
//最新代码还没更新到 jcenter 仓库,推荐使用方法二依赖项目
compile 'com.github.baserecycleradapter:library:1.1.0'
如果上面的依赖不能使用,使用新的依赖
compile 'com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.22'
如果导入依赖报错:
Error:(33, 13) Failed to resolve: com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.22
Show in File
Show in Project Structure dialog
在导入依赖页面加上如下代码:
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
导入依赖之后
public class DeleteDemoAdapter extends BaseQuickAdapter<String,BaseViewHolder> {
public DeleteDemoAdapter(@LayoutRes int layoutResId, @Nullable ArrayList<String> data) {
super(layoutResId, data);
}
@Override
protected void convert(final BaseViewHolder helper, String item) {
helper.setText(R.id.tv_content,item);
}
}
然后在视图页面使用:关键代码
adapter=new DeleteDemoAdapter(R.layout.item_layout,datas);
list.setAdapter(adapter);
注解:上面的String,可以是数据的实体类
方式二:下载源码:https://github.com/HpWens/WRecyclerView,添加 library 库到你项目当中。
这里推荐使用方法二依赖进项目。
BaseQuickAdapter 使用
mRecyclerView.setAdapter(mAdapter = new BaseQuickAdapter<String, BaseViewHolder>(R.layout.rv_item, getItemDatas()) {
@Override
protected void convert(final BaseViewHolder helper, String item) {
helper.setText(R.id.tv_item_text, item);
}
});
- 1
Item点击,长按事件
//Item 点击事件
setOnItemClickListener(int viewId, AdapterView.OnItemClickListener listener)
//长按事件
setOnItemLongClickListener(int viewId, AdapterView.OnItemLongClickListener listener)
- 1
- 2
- 3
- 4
- 5
子控件的点击事件
helper.setOnClickListener(R.id.tv_item_text, new View.OnClickListener() {
@Override
public void onClick(View v) {
//事件处理
}
});
添加头部,尾部
//头部
mAdapter.addHeaderView();
//尾部
mAdapter.addFooterView();
- 1
以下是添加头部的代码:
View headerView=getLayoutInflater().inflate(R.layout.rv_header, null);
headerView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,ViewGroup.LayoutParams.WRAP_CONTENT));
mAdapter.addHeaderView(headerView);
- 1
部的添加与头部的添加类似。
添加 Item动画
//一行代码开启动画 默认CUSTOM动画
mAdapter.openLoadAnimation(BaseQuickAdapter.CUSTOMIN);
- 1
- 2
- 3
- 4
- 5
当然你可以更换其他动画:
//ALPHAIN, SCALEIN, SLIDEIN_BOTTOM, SLIDEIN_LEFT, SLIDEIN_RIGHT, //SLIDEIN_LEFT_RIGHT, SLIDEIN_BOTTOM_TOP, CUSTOMIN
mAdapter.openLoadAnimation(BaseQuickAdapter.CUSTOMIN);
最后你可以自定义 Item动画:
mAdapter.openLoadAnimation(new BaseAnimation[]{
new BaseAnimation() {
@Override
public Animator[] getAnimators(View view) {
return new Animator[]{ObjectAnimator.ofFloat(view, "alpha", 0.5f, 1.0f),
ObjectAnimator.ofFloat(view, "scaleX", 0.5f, 1.0f)};
}
}
});
设置加载更多
只需要设置加载更多接口,就可以实现加载更多功能。
mAdapter.setOnLoadMoreListener(new BaseQuickAdapter.RequestLoadMoreListener() {
@Override
public void onLoadMoreRequested() {
}
});
以下演示正在加载中,加载失败点击重试,加载完成等状态:
mShowType++;
if (mShowType == 2) {
mHandler.postDelayed(new Runnable() {
@Override
public void run() {
//加载失败,点击重试
mAdapter.loadMoreFail();
}
}, DELAY_MILLIS);
} else if (mShowType >= 4) {
mHandler.post(new Runnable() {
@Override
public void run() {
//加载完成
mAdapter.loadMoreEnd();
}
});
} else {
mHandler.postDelayed(new Runnable() {
@Override
public void run() {
mAdapter.addData(addDatas());
//加载更多完成
mAdapter.loadMoreComplete();
}
}, DELAY_MILLIS);
}
你可以设置加载更多类型,只需要添加一行代码,实现不同的加载更多动画:
//设置加载更多 loadingview
setLoadMoreType(@LoadMoreType int loadMoreType)
- 1
- 2
- 3
这里有四种模式供你选择,APAY, BALL_BEAT, BALL_CLIP_ROTATE, BALL_SCALE
,如果都不满足你的需求,你可以继承 BaseIndicator
类从新加载视图,或给我留言。
添加空布局
View emptyView=getLayoutInflater().inflate(R.layout.rv_empty, null);
emptyView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
ViewGroup.LayoutParams.MATCH_PARENT));
//添加空视图
mAdapter.setEmptyView(emptyView)
emptyView.OnClickListener() { @Override public void onClick(View view) { Snackbar.make(view, "your click empty", Snackbar.LENGTH_SHORT).show() } }) 拖拽和侧滑,添加以下代码: ItemTouchHelper.Callback callback = new SimpleItemTouchHelperCallback(mAdapter)
ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(callback)
mAdapter.setItemTouchHelper(mItemTouchHelper)
mAdapter.setDragViewId(R.id.iv_drag);
mItemTouchHelper.attachToRecyclerView(mRecyclerView);
支持不同类型
mRecyclerView.setAdapter(mAdapter = new BaseMultiItemAdapter<MultiItem>(this, getMultiItemDatas()) {
@Override
protected void convert(BaseViewHolder helper, MultiItem item) {
switch (helper.getItemViewType()) {
case MultiItem.SEND:
helper.setText(R.id.chat_from_content, item.content);
//helper.setImageBitmap(R.id.chat_from_icon,getRoundCornerBitmap(BitmapFactory.decodeResource(getResources(), R.mipmap.chat_head), 16));
break;
case MultiItem.FROM:
helper.setText(R.id.chat_send_content, item.content);
//helper.setImageBitmap(R.id.chat_send_icon,getRoundCornerBitmap(BitmapFactory.decodeResource(getResources(), R.mipmap.from_head), 16));
break;
}
}
@Override
protected void addItemLayout() {
addItemType(MultiItem.SEND, R.layout.chat_send_msg);
addItemType(MultiItem.FROM, R.layout.chat_from_msg);
}
});
mAdapter.openLoadAnimation(true);
btnSend.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
MultiItem multiItem = new MultiItem();
multiItem.itemType = MultiItem.SEND;
multiItem.content = etChat.getText().toString();
mAdapter.add(multiItem);
mRecyclerView.smoothScrollToPosition(mAdapter.getItemCount());
//mRecyclerView.scrollToPosition(mAdapter.getItemCount() - 1);
}
});
数据源:
public static List<MultiItem> getMultiItemDatas() {
List<MultiItem> list = new ArrayList<>();
for (int i = 0; i < 100; i++) {
MultiItem multiItem = new MultiItem();
if (i % 2 == 0) {
multiItem.itemType = MultiItem.SEND;
multiItem.content = "海,妹子约吗";
} else {
multiItem.itemType = MultiItem.FROM;
multiItem.content = "大哥,你别怕";
}
list.add(multiItem);
}
return list;
}
这样就轻松实现了聊天界面。
这样简单的配置就可以实现多类型布局,不需要你写格外的代码。
流式布局
先来看看效果图:
一行代码实现流式布局效果:
mRecyclerView.setLayoutManager(new FlowLayoutManager());
- 1
探探翻牌
类似流式效果,重写 LayoutManager 实现翻牌效果:
mRecyclerView.setLayoutManager(new OverLayCardLayoutManager());
- 1
//添加 itemTouchHelper
final TanTanCallback callback = new TanTanCallback(mRecyclerView, mAdapter, mAdapter.getData());
//测试竖直滑动是否已经不会被移除屏幕
//callback.setHorizontalDeviation(Integer.MAX_VALUE);
final ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback);
itemTouchHelper.attachToRecyclerView(mRecyclerView);
效果图一览:
具体实现请参考 Demo
淘宝商品列表切换
先来看看效果图:
看看代码的实现:
//线性
if (mIsLinearManager) {
mAdapter.setLayoutType(BaseQuickAdapter.TRANS_0_VIEW);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
} else {
//网格
mAdapter.setLayoutType(BaseQuickAdapter.TRANS_1_VIEW);
mRecyclerView.setLayoutManager(new GridLayoutManager(this, 2));
//需要显示加载更多则加上下面这句 从新关联recycler
mAdapter.onAttachedToRecyclerView(mRecyclerView);
}
mIsLinearManager = !mIsLinearManager;
注意:最多支持3种不同类型的转换。
单选
实现单选,有好几位同仁都在问我,其实实现单选是比较简单的,方案也比较多,我这里就不在细讲了。下面我给出一种实现方案:
public void setItemChecked(int position) {
if (mLastCheckedPosition == position)
return;
mBooleanArray.put(position, true); if (mLastCheckedPosition -1) { mBooleanArray.put(mLastCheckedPosition,false); mAdapter.notifyItemChanged(mLastCheckedPosition); } mAdapter.notifyDataSetChanged(); mLastCheckedPosition = position; } mBooleanArray 存储是否被点击,把点击前的索引值置为 false , 点击索引置为 true 。