android view wrapper,Android开源项目 RecyclerViewHelper

1.写在前面

2019年的第一篇文章，分享一个自己写的开源项目，主要是对RecyclerView控件的一些常用功能封装， 包括(上拉加载更多、头尾布局、拖拽排序、侧滑删除、侧滑选择、万能分割线)。

RecyclerViewHelper主要使用了装饰者模式对项目原有的Adapter进行功能扩展，不会影响项目的原有结构，集成和修改都非常方便，一起来看下。

2.引入依赖库在项目根目录的build.gradle文件中加入如下代码：allprojects {

repositories {

maven { url "https://jitpack.io" }

}

}在app根目录的buil.gradle文件中加入依赖：dependencies {

implementation 'com.github.alidili:RecyclerViewHelper:1.0.0'}

截止此篇文章发布时，最新版本为1.0.0，最新版本可在GitHub中查看。

RecyclerViewHelper中使用的RecyclerView版本如下：implementation "androidx.recyclerview:recyclerview:1.0.0"

3.上拉加载更多

效果图：

上拉加载更多

集成：// CommonAdapter为项目原有AdapterCommonAdapter commonAdapter = new CommonAdapter(mDataList);

mLoadMoreWrapper = new LoadMoreWrapper(commonAdapter);// 自定义加载布局customLoadingView();

mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

mRecyclerView.setAdapter(mLoadMoreWrapper);// 设置上拉加载监听mRecyclerView.addOnScrollListener(new OnScrollListener() {    @Override

public void onLoadMore() {        // 设置数据正在加载状态，可自定义布局

mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING);        if (mDataList.size() 

// 设置数据加载完成状态，可自定义布局

mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING_COMPLETE);

} else {            // 设置所有数据加载完成状态，可自定义布局

mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING_END);

}

}

});// 刷新数据需要使用外层AdaptermLoadMoreWrapper.notifyDataSetChanged();

自定义加载布局：private void customLoadingView() {    // 正在加载布局

ProgressBar progressBar = new ProgressBar(this);

mLoadMoreWrapper.setLoadingView(progressBar);    // 所有数据加载完成布局

TextView textView = new TextView(this);

textView.setText("End");

mLoadMoreWrapper.setLoadingEndView(textView);    // 布局高度

mLoadMoreWrapper.setLoadingViewHeight(DensityUtils.dp2px(this, 50));

}

4.头尾布局

效果图：

头尾布局

集成：// CommonAdapter为项目原有AdapterCommonAdapter commonAdapter = new CommonAdapter(mDataList);

mHeaderAndFooterWrapper = new HeaderAndFooterWrapper(commonAdapter);// 添加头尾布局addHeaderAndFooterView();

mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

mRecyclerView.setAdapter(mHeaderAndFooterWrapper);// 刷新数据需要使用外层AdaptermHeaderAndFooterWrapper.notifyDataSetChanged();

添加头尾布局：private void addHeaderAndFooterView() {    // 头布局

View headerView = View.inflate(this, R.layout.layout_header_footer, null);

TextView headerItem = headerView.findViewById(R.id.tv_item);

headerItem.setText("HeaderView");

mHeaderAndFooterWrapper.addHeaderView(headerView);    // 尾布局

View footerView = View.inflate(this, R.layout.layout_header_footer, null);

TextView footerItem = footerView.findViewById(R.id.tv_item);

footerItem.setText("FooterView");

mHeaderAndFooterWrapper.addFooterView(footerView);

}

5.拖拽排序

效果图：

拖拽排序

集成：// CommonAdapter为项目原有AdapterCommonAdapter commonAdapter = new CommonAdapter(mDataList);// 拖拽事件响应时间默认为200ms，可自定义mDragAndDropWrapper = new DragAndDropWrapper(commonAdapter, mDataList, 200);

mDragAndDropWrapper.attachToRecyclerView(mRecyclerView, true);

mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

mRecyclerView.setAdapter(mDragAndDropWrapper);// 刷新数据需要使用外层AdaptermDragAndDropWrapper.notifyDataSetChanged();

6.侧滑删除

效果图：

侧滑删除

集成：// CommonAdapter为项目原有AdapterCommonAdapter commonAdapter = new CommonAdapter(mDataList);

mSwipeToDismissWrapper = new SwipeToDismissWrapper(commonAdapter, mDataList);

mSwipeToDismissWrapper.attachToRecyclerView(mRecyclerView);

mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

mRecyclerView.setAdapter(mSwipeToDismissWrapper);// 设置删除事件监听mSwipeToDismissWrapper.setItemDismissListener(new ItemSwipeCallback.ItemDismissListener() {    @Override

public void onItemDismiss(final int position) {        // TODO

}

});// 刷新数据需要使用外层AdaptermSwipeToDismissWrapper.notifyDataSetChanged();

7.侧滑选择

效果图：

侧滑选择

集成：<?xml  version="1.0" encoding="utf-8"?>

android:id="@+id/slide_item"

android:layout_width="match_parent"

android:layout_height="40dp">

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="horizontal">

// Item布局        

android:layout_width="140dp"

android:layout_height="match_parent"

android:orientation="horizontal">

// 功能按钮        

SlideItemView控件是通用的，不局限于RecyclerView，也可以配合其他控件或者单独使用。

8.万能分割线

效果图：

万能分割线

集成：// CommonAdapter为项目原有AdaptermDividerAdapter = new DividerAdapter(mDataList);

LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);

mRecyclerView.setLayoutManager(linearLayoutManager);// 设置分割线SuperDividerItemDecoration dividerItemDecoration = new SuperDividerItemDecoration(this, linearLayoutManager);// 分割线样式可自定义dividerItemDecoration.setDrawable(getResources().getDrawable(R.drawable.custom_bg_divider));

mRecyclerView.addItemDecoration(dividerItemDecoration);

mRecyclerView.setAdapter(mDividerAdapter);

分割线样式：<?xml  version="1.0" encoding="utf-8"?>

android:shape="rectangle">

android:width="5dp"

android:height="5dp" />

作者：容华谢后

链接：https://www.jianshu.com/p/827769fc0290