RecyclerView的老婆,万能设配器BaseQuickAdapter

转载 2018年04月16日 15:37:34

RecyclerView 是Android L版本中新添加的一个用来取代ListView的SDK,它的灵活性与可替代性比listview更好。RecyclerView 同样也用到适配,枯燥重复的适配肯定会让你不胜其烦,下面让我们一起来打造一款通用的适配(BaseQuickAdapter)。受益群体几乎是所有Android开发者,希望更你们能够一起来维护这个项目,把这个项目做得更好,帮助更多人。

看到这里你肯定会有疑问,通用适配(BaseQuickAdapter),它具体能够做些什么呢,或者说它都有哪些功能?

这里非常感谢 经天纬地

本文结合他文章和我的一些修改,希望大家能够喜欢。

一、BaseQuickAdapter 简介

  • 减少重复 Adapter 代码

  • 添加 Item 的点击事件,长按事件以及子控件的点击事件

  • 添加头部、尾部,下拉刷新、上拉加载(上拉加载的5种加载更多动画任你选择,后期会添加更多的加载动画)、没有更多数据

  • 可以自定义头部、尾部、加载更多布局

  • 添加 Item滑动动画 (9种动画切换,轻松一行代码)

  • 添加新增、删除 Item动画 (目前支持默认的动画方式)

  • 网格,列表,流式随意切换

  • 添加空布局(列表无数据时,显示更加人性化)

  • 拖拽和侧滑删除

  • 支持多类型布局

  • 类似淘宝列表切换

  • 字母导航

  • 类似探探翻牌

看了 BaseQuickAdapter 的特性,接着来看看外面如何在项目中导入(依赖)它。

BaseQuickAdapter 导入(依赖)

build.gradle 的 dependencies 添加如下代码:

//最新代码还没更新到 jcenter 仓库,推荐使用方法二依赖项目
compile 'com.github.baserecycleradapter:library:1.1.0'

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);

    }
});     

recy


Item点击,长按事件

//Item 点击事件
setOnItemClickListener(int viewId, AdapterView.OnItemClickListener listener)

//长按事件
setOnItemLongClickListener(int viewId, AdapterView.OnItemLongClickListener listener)

recy

子控件的点击事件

   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);

recy

部的添加与头部的添加类似。

添加 Item动画

recy

 //一行代码开启动画 默认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() {
        }
    });

recy

以下演示正在加载中,加载失败点击重试,加载完成等状态:

    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)

这里有四种模式供你选择,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();
        }
    });

recy


拖拽和侧滑

添加以下代码:

ItemTouchHelper.Callback callback = new SimpleItemTouchHelperCallback(mAdapter);

ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(callback);

mAdapter.setItemTouchHelper(mItemTouchHelper);

mAdapter.setDragViewId(R.id.iv_drag);

mItemTouchHelper.attachToRecyclerView(mRecyclerView);

recycler


支持不同类型

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;
}
  • recycler

这样就轻松实现了聊天界面。

这样简单的配置就可以实现多类型布局,不需要你写格外的代码。

流式布局

先来看看效果图:

flow

一行代码实现流式布局效果:

mRecyclerView.setLayoutManager(new FlowLayoutManager());

探探翻牌

类似流式效果,重写 LayoutManager 实现翻牌效果:

 mRecyclerView.setLayoutManager(new OverLayCardLayoutManager());

//添加 itemTouchHelper

    final TanTanCallback callback = new TanTanCallback(mRecyclerView, mAdapter, mAdapter.getData());
    //测试竖直滑动是否已经不会被移除屏幕
    //callback.setHorizontalDeviation(Integer.MAX_VALUE);
    final ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback);
    itemTouchHelper.attachToRecyclerView(mRecyclerView);

效果图一览:

tantan

具体实现请参考 Demo

淘宝商品列表切换

先来看看效果图:

taobao

看看代码的实现:

        //线性
        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 。

sel

BaseQuickAdapter 简介

一、BaseQuickAdapter 简介减少重复 Adapter 代码添加 Item 的点击事件,长按事件以及子控件的点击事件添加头部、尾部,下拉刷新、上拉加载(上拉加载的5种加载更多动画任...
  • zuo_er_lyf
  • zuo_er_lyf
  • 2018-01-30 15:58:58
  • 133

BaseRecyclerAdapter之添加不同布局(头部尾部)

最近写了个Android开源库「BaseRecyclerViewAdapterHelper」集成了很多常见需求的解决方案,希望大家多多star哦~! 效果如何?如何使用?多个不同布局public cl...
  • cym492224103
  • cym492224103
  • 2016-04-22 00:37:52
  • 15413

QuickAdapter 的创建

详解:http://blog.csdn.net/lmj623565791/article/details/44014941这里是只支持一种布局的Quick,要使用多种布局,参考以上链接, 注意:由于s...
  • qq_32223565
  • qq_32223565
  • 2016-05-12 09:30:30
  • 1937

BaseRecyclerAdapter之添加不同布局(优化篇)

由于之前发了篇「BaseRecyclerAdapter之添加不同布局(头部尾部)」收到了以下反馈,在此非常感谢,宝贵建议!希望加群多多提建议,让这个项目更加好用,帮助到更多人。 目...
  • cym492224103
  • cym492224103
  • 2016-04-22 18:35:27
  • 15118

RecyclerView万能适配器加强版———可选择添加头和尾(含点击事件)

最近项目中要实现RecyclerView添加头尾,后在度娘的帮助下完成任务;就在自己为此而窃喜的时候,一个念头飞入我的脑海:将添加头尾的逻辑封装到RecyclerView的万能适配器中,实现可以选择添...
  • qq_33923079
  • qq_33923079
  • 2016-09-21 03:46:29
  • 581

基于BaseQuickAdapter的RecyclerView无限循环

这里写的是自动滚动并“无限”循环的代码自动滚动代码TimerTask mTimerTask = new TimerTask() { @Override public v...
  • qq_19269585
  • qq_19269585
  • 2017-12-12 14:38:41
  • 126

BaseRecyclerViewAdapterHelper源码解读(二) 添加header和footer

BaseRecyclerViewAdapterHelper源码解读(二) 添加header和footer原项目地址: https://github.com/CymChad/BaseRecyclerV...
  • xfhy_
  • xfhy_
  • 2017-10-18 16:55:03
  • 422

强大的BaseRecyclerViewAdapterHelper使用

介绍 相信大家RecyclerView应该不会陌生,大多数开发者应该都使用上它了,它也是google推荐替换ListView的控件,但是用过它的同学应该都知道它在某些方面并没有ListView使用起...
  • qq_37293612
  • qq_37293612
  • 2017-02-09 09:45:43
  • 25428

BaseRecyclerViewAdapterHelper开源项目之BaseQuickAdapter源码学习之预加载的实现(二)

version:2.8.5 更多分享请看:  http://cherylgood.cn 又是美好的第一天,今天我们来学习下有关自动加载更多以及预加载相关的代码。 首先我们今天的切入点是:auto...
  • jiecsdn
  • jiecsdn
  • 2017-03-13 13:12:31
  • 1204

RefreshRecyclerView

  • 2017年01月06日 13:51
  • 83KB
  • 下载
收藏助手
不良信息举报
您举报文章:RecyclerView的老婆,万能设配器BaseQuickAdapter
举报原因:
原因补充:

(最多只允许输入30个字)