RecyclerViewAdapter: Android RecyclerView 通用适配器，支持多ViewType，嵌套Sectio ...

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称：

RecyclerViewAdapter

开源软件地址：

https://gitee.com/vanish136_admin/RecyclerViewAdapter

开源软件介绍：

RecyclerViewAdapter

想了解该框架的可参考以下博客说明：
CSDN：http://blog.csdn.net/lwk520136/article/details/70787798
简书：http://www.jianshu.com/p/c86a39f4e811

引用方式

【最新版本号以这里为准】

由于JCenter关闭服务，从1.4.5版本开始改为发布到MavenCentral，引用方式有更新！！！
由于JCenter关闭服务，从1.4.5版本开始改为发布到MavenCentral，引用方式有更新！！！
由于JCenter关闭服务，从1.4.5版本开始改为发布到MavenCentral，引用方式有更新！！！

#last-version请查看上面的最新版本号#只支持AndroidX#从1.4.5版本开始GroupId、ArtifactId均有更新，请按如下方式引用implementation "com.lwkandroid.library:rcvadapter:last-version"

基础功能

快速实现适配器，支持多种ViewType模式
支持添加HeaderView、FooterView、EmptyView
支持滑到底部加载更多
支持每条Item显示的动画
支持嵌套Section（1.1.0版本新增）
支持悬浮标签StickyLayout（1.2.0版本新增）

效果图

使用方式

1. 当Item样式一样时，只需继承RcvSingleAdapter<T>即可，示例：

public class TestSingleAdapter extends RcvSingleAdapter<TestData>{    public TestSingleAdapter(Context context, List<TestData> datas)    {        super(context, android.R.layout.simple_list_item_1, datas);    }    @Override    public void onBindView(RcvHolder holder, TestData itemData, int position)    {	    //在这里绑定UI和数据，RcvHolder中提供了部分快速设置数据的方法，详情请看源码        holder.setTvText(android.R.id.text1, itemData.getContent());    }}

2. 当Item样式不一样时，即存在多种ViewType类型的Item，需要将每种ViewType的Item单独实现，再关联到RcvMultiAdapter<T>中，示例：

//第一步：每种Item分别继承RcvBaseItemView<T>public class LeftItemView extends RcvBaseItemView<TestData>{    @Override    public int getItemViewLayoutId()    {	    //这里返回该Item的布局id        return R.layout.layout_item_left;    }    @Override    public boolean isForViewType(TestData item, int position)    {	    //这里判断何时引用该Item        return position % 2 == 0;    }    @Override    public void onBindView(RcvHolder holder, TestData testData, int position)    {	    //在这里绑定UI和数据，RcvHolder中提供了部分快速设置数据的方法，详情请看源码        holder.setTvText(R.id.tv_left, testData.getContent());    }}//第二步：将所有Item关联到适配器中public class TestMultiAdapter extends RcvMultiAdapter<TestData>{    public TestMultiAdapter(Context context, List<TestData> datas)    {        super(context, datas);        //只需在构造方法里将所有Item关联进来,无论多少种ViewType都轻轻松松搞定        addItemView(new LeftItemView());        addItemView(new RightItemView());    }}

3.优雅的添加HeaderView、FooterView、EmptyView，只需要在RecyclerView设置LayoutManager后调用相关方法即可：

//要先设置LayoutManagermRecyclerView.setLayoutManager(new LinearLayoutManager(context, LinearLayoutManager.VERTICAL, false));//添加HeaderView(若干个)mAdapter.addHeaderView(headerView01,headerView02,headerView03...);//添加FooterView(若干个)mAdapter.addFooterView(footerView01,footerView02,footerView03...);//添加EmptyView（只能设置一个）//设置了EmptyView后，当数据量为0的时候会显示EmptyViewmAdapter.setEmptyView(emptyView);或者mAdapter.setEmptyView(layoutId);

4.设置滑动到底部自动加载更多，先上示例代码吧：

自1.4.3版本开始删除了之前的调用方式

//可以先设置加载样式，继承RcvBaseLoadMoreView实现自定义样式//不设置的话会使用默认的样式，参考RcvDefLoadMoreView源码RcvDefLoadMoreView loadMoreView = new RcvDefLoadMoreView.Builder()                .setBgColor(Color.GREEN)                .setTextColor(Color.RED)                .build(this);mAdapter.setLoadMoreLayout(loadMoreView);//再开启并设置监听mAdapter.enableLoadMore(true);mAdapter.setOnLoadMoreListener(RcvLoadMoreListener listener);//禁止加载更多,通常用在配合下拉刷新的过程中mAdapter.enableLoadMore(false);

注：
① 默认的样式实现是类RcvDefLoadMoreView
② 如需自定义样式，只需继承RcvBaseLoadMoreView，只要重写各状态UI的实现，无须关心状态切换，可参考RcvDefLoadMoreView内的实现方式。

5.设置Item显示动画，先直接上代码：

//使用默认的动画（Alpha动画）mAdapter.enableItemShowingAnim(true);//使用自定义动画mAdapter.enableItemShowingAnim(true, ? extends RcvBaseAnimation);

注：
①默认动画的实现是类RcvAlphaInAnim
②自定义样式需要继承RcvBaseAnimation，可参考RcvAlphaInAnim内部实现。

6.设置Item点击监听：

    //设置OnItemClickListener    mAdapter.setOnItemClickListener(new RcvItemViewClickListener<TestData>()        {            @Override            public void onItemViewClicked(RcvHolder holder, TestData testData, int position)            {                //onClick回调            }        });    //设置OnItemLongClickListener    mAdapter.setOnItemLongClickListener(new RcvItemViewLongClickListener<TestData>()        {            @Override            public void onItemViewLongClicked(RcvHolder holder, TestData testData, int position)            {                //onLongClick回调            }        });

7. 添加分割线，直接上代码：

1.2.9版本针对分割线进行了重写，原有方法不变，新增支持自定义颜色和部分快速创建的方法：

#适用于LinearLayoutManager//创建默认竖直排列的分割线RcvLinearDecoration.createDefaultVertical(Context context);//创建自定义色值默认竖直排列的分割线RcvLinearDecoration.createDefaultVertical(int color);//创建默认水平排列的分割线RcvLinearDecoration.createDefaultHorizontal(Context context);//创建自定义色值默认水平排列的分割线RcvLinearDecoration.createDefaultHorizontal(int color);//构造方法：默认Drawable分割线new RcvLinearDecoration(Context context, int orientation);//构造方法：自定义Drawable分割线new RcvLinearDecoration(Context context, Drawable drawable, int orientation);//构造方法：自定义Drawable分割线new RcvLinearDecoration(Context context, @DrawableRes int drawableResId, int orientation);//构造方法：自定义Color分割线（宽度或者高度默认1px）new RcvLinearDecoration(@ColorInt int color, int orientation);//构造方法：自定义Color分割线new RcvLinearDecoration(@ColorInt int color, int size, int orientation);#适用于GridLayoutManager、StaggeredGridLayoutManager//创建默认分割线RcvGridDecoration.createDefault(Context context);//创建自定义色值默认分割线RcvGridDecoration.createDefault(int color);//构造方法：默认Drawable的分割线new RcvGridDecoration(Context context);//构造方法：自定义Drawable的分割线new RcvGridDecoration(Context context, Drawable drawable);//构造方法：自定义Drawable的分割线new RcvGridDecoration(Context context, @DrawableRes int drawableResId);//构造方法：自定义Color的分割线（默认分割线宽高均为1px）new RcvGridDecoration(@ColorInt int color);//构造方法：自定义Color的分割线new RcvGridDecoration(@ColorInt int color, int width, int height);

注：
①是直接设置给RecyclerView的，不是设置给适配器的，不要看错哦
②支持自定义drawable当分割线

8.嵌套Section，稍微复杂一点，配合代码讲解：

1.4.0版本开始删除以前的使用方法，采用下面的方式

带有Section功能的适配器为RcvSectionMultiLabelAdapter和RcvSectionSingleLabelAdapter,需要指定两个泛型，第一个代表Section，第二个代表普通数据Data，两者都支持多种Data类型的子布局，唯一不同的是，RcvSectionMultiLabelAdapter还支持多种Section类型的子布局，但不可以和RcvStickyLayout联动，而RcvSectionSingleLabelAdapter仅支持一种Section类型的子布局，但是可以和RcvStickyLayout联动。需要注意的是，传给适配器的数据均需要自行预处理，用RcvSectionWrapper封装后才可传入适配器。

#只有一种Section类型，配合多种Data类型的适配器public class TestSectionAdapter extends RcvSectionSingleLabelAdapter<TestSection, TestData>{    public TestSectionAdapter(Context context, List<RcvSectionWrapper<TestSection, TestData>> datas)    {        super(context, datas);    }    @Override    protected RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>[] createDataItemViews()    {        return new RcvBaseItemView[]{new DataItemView01(), new DataItemView02()};    }    @Override    public int getSectionLabelLayoutId()    {        return R.layout.layout_section_label;    }    @Override    public void onBindSectionLabelView(RcvHolder holder, TestSection section, int position)    {        holder.setTvText(R.id.tv_section_label, section.getSection());    }    //第一种Data ItemView    private class DataItemView01 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.adapter_item_long;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return !item.isSection() && item.getData().getType() == 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            TextView textView = holder.findView(R.id.tv_item_long);            textView.setBackgroundColor(Color.GREEN);            textView.setText("第一种数据类型：" + wrapper.getData().getContent());        }    }    //第二种Data ItemView    private class DataItemView02 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.adapter_item_short;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return !item.isSection() && item.getData().getType() != 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            TextView textView = holder.findView(R.id.tv_item_short);            textView.setBackgroundColor(Color.RED);            textView.setText("第二种数据类型：" + wrapper.getData().getContent());        }    }}#多种Section类型，配合多种Data类型的适配器public class TestSectionMultiLabelAdapter extends RcvSectionMultiLabelAdapter<TestSection, TestData>{    public TestSectionMultiLabelAdapter(Context context, List<RcvSectionWrapper<TestSection, TestData>> datas)    {        super(context, datas);    }    @Override    protected RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>[] createLabelItemViews()    {        return new RcvBaseItemView[]{new LabelItemView01(), new LabelItemView02()};    }    @Override    protected RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>[] createDataItemViews()    {        return new RcvBaseItemView[]{new DataItemView01(), new DataItemView02()};    }    //第一种Label ItemView    private class LabelItemView01 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.layout_section_label;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return item.isSection() && item.getSection().getType() == 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            holder.setTvText(R.id.tv_section_label, wrapper.getSection().getSection());        }    }    //第二种Label ItemView    private class LabelItemView02 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.layout_section_label02;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return item.isSection() && item.getSection().getType() != 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            holder.setTvText(R.id.tv_section_label, wrapper.getSection().getSection());        }    }    //第一种Data ItemView    private class DataItemView01 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.adapter_item_long;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return !item.isSection() && item.getData().getType() == 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            TextView textView = holder.findView(R.id.tv_item_long);            textView.setBackgroundColor(Color.GREEN);            textView.setText("第一种数据类型：" + wrapper.getData().getContent());        }    }    //第二种Data ItemView    private class DataItemView02 extends RcvBaseItemView<RcvSectionWrapper<TestSection, TestData>>    {        @Override        public int getItemViewLayoutId()        {            return R.layout.adapter_item_short;        }        @Override        public boolean isForViewType(RcvSectionWrapper<TestSection, TestData> item, int position)        {            return !item.isSection() && item.getData().getType() != 0;        }        @Override        public void onBindView(RcvHolder holder, RcvSectionWrapper<TestSection, TestData> wrapper, int position)        {            TextView textView = holder.findView(R.id.tv_item_short);            textView.setBackgroundColor(Color.RED);            textView.setText("第二种数据类型：" + wrapper.getData().getContent());        }    }}

注：
①传给适配器的数据集合内实体类必须经过RcvSectionWrapper包装。
②向外公布的方法（例如点击监听）的实体类泛型不能传错。

9.悬浮标签StickyLayout

适配器方面无需改动，直接使用RcvSectionSingleLabelAdapter即可，在RecyclerView同级布局下添加RcvStickyLayout，然后在代码中关联起来即可：

    // xml布局中添加RcvStickyLayout：    <FrameLayout        android:layout_width="match_parent"        android:layout_height="match_parent">        <android.support.v7.widget.RecyclerView            android:id="@+id/rcv_sticky"            android:layout_width="match_parent"            android:layout_height="match_parent"/>        <com.lwkandroid.rcvadapter.ui.RcvStickyLayout            android:id="@+id/stickyLayout"            android:layout_width="match_parent"            android:layout_height="wrap_content"/>    </FrameLayout>    //代码中关联RecyclerView    RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rcv_sticky);    /...省略设置RecyclerView的LayoutMananger和Adapter.../    RcvStickyLayout stickyLayout = (RcvStickyLayout) findViewById(R.id.stickyLayout);    stickyLayout.attachToRecyclerView(recyclerView);

上面就是大部分基础功能的使用方法了，想了解更多方法请看源码。

混淆配置

-dontwarn com.lwkandroid.rcvadapter.**-keep class com.lwkandroid.rcvadapter.**{*;}

待实现功能

暂时未想到

开源参考

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

ILayoutAnimationController: 自定义LayoutAnimationController，可任意定制ViewGroup ...发布时间：2022-03-24

Android_CountDown: 一个好看的Android倒计时控件，避免造轮子发布时间：2022-03-24

客服电话

电子邮件

RecyclerViewAdapter: Android RecyclerView 通用适配器，支持多ViewType，嵌套Sectio ...

开源软件名称：

开源软件地址：

开源软件介绍：

RecyclerViewAdapter

引用方式

基础功能

效果图

使用方式

混淆配置

待实现功能

开源参考

请发表评论

全部评论

上一篇：

下一篇：

关于我们

产品与服务

解决方案

139-2527-9053