本篇来自：https://blog.csdn.net/u012551350/article/details/52026740
RecyclerView 是Android L版本中新添加的一个用来取代ListView的SDK，它的灵活性与可替代性比listview更好。RecyclerView 同样也用到适配，枯燥重复的适配肯定会让你不胜其烦，下面让我们一起来打造一款通用的适配（BaseQuickAdapter）。受益群体几乎是所有Android开发者，希望更你们能够一起来维护这个项目，把这个项目做得更好，帮助更多人。
看到这里你肯定会有疑问，通用适配（BaseQuickAdapter），它具体能够做些什么呢，或者说它都有哪些功能？
这里非常感谢?陈宇明
本文结合他文章和我的一些修改，希望大家能够喜欢。
一、BaseQuickAdapter 简介
1、减少重复 Adapter 代码
2、添加 Item 的点击事件，长按事件以及子控件的点击事件
3、添加头部、尾部，下拉刷新、上拉加载（上拉加载的5种加载更多动画任你选择，后期会添加更多的加载动画）、没有更多数据
4、可以自定义头部、尾部、加载更多布局
5、添加 Item滑动动画 （9种动画切换，轻松一行代码）
6、添加新增、删除 Item动画 （目前支持默认的动画方式）
7、网格，列表，流式随意切换
8、添加空布局（列表无数据时，显示更加人性化）
9、拖拽和侧滑删除
10、支持多类型布局
11、类似淘宝列表切换
12、字母导航
13、类似探探翻牌
看了 BaseQuickAdapter 的特性，接着来看看外面如何在项目中导入（依赖）它。
BaseQuickAdapter 导入（依赖）
方式一：build.gradle 的 dependencies 添加如下代码：
//最新代码还没更新到 jcenter 仓库，推荐使用方法二依赖项目
compile 'com.github.baserecycleradapter:library:1.1.0'
方式二：下载源码，添加?library?库到你项目当中。
这里推荐使用方法二依赖进项目。
BaseQuickAdapter 使用
mRecyclerView.setAdapter(mAdapter = new BaseQuickAdapter(R.layout.rv_item, getItemDatas()) {
@Override
protected void convert(final BaseViewHolder helper, String item) {
?helper.setText(R.id.tv_item_text, item);
?}
?});
Item点击，长按事件
//Item 点击事件
setOnItemClickListener(int viewId, AdapterView.OnItemClickListener listener)
//长按事件
setOnItemLongClickListener(int viewId, AdapterView.OnItemLongClickListener listener)
子控件的点击事件
helper.setOnClickListener(R.id.tv_item_text, new View.OnClickListener() {
? ? ? @Override? ? ? public void onClick(View v) {
? ? ? ? ? //事件处理? ? ? }
? });
添加头部，尾部
//头部 mAdapter.addHeaderView();
?//尾部? ? mAdapter.addFooterView();
以下是添加头部的代码：
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);
部的添加与头部的添加类似。
添加 Item动画
//一行代码开启动画 默认CUSTOM动画?
mAdapter.openLoadAnimation(BaseQuickAdapter.CUSTOMIN);
当然你可以更换其他动画：
//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(@LoadMoreTypeintloadMoreType)
这里有四种模式供你选择，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.setOnClickListener(new View.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(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 getMultiItemDatas() {
? ? List 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(newFlowLayoutManager());
探探翻牌
类似流式效果，重写 LayoutManager 实现翻牌效果：
mRecyclerView.setLayoutManager(newOverLayCardLayoutManager());
//添加 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 。
敬请大家的关注，后期会一直维护本库，有什么好的想法，可以提出来。我们互相学习进度。 下一个版本会自定义下拉刷新，全新多项的刷新贡大家喜欢。再次感谢大家一直对我的关注，新年将近，祝愿大家新年新气象，新年大吉！
