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() < 52) { // 获取数据 // 设置数据加载完成状态,可自定义布局 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"?><com.yl.recyclerview.widget.SlideItemView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/slide_item" android:layout_width="match_parent" android:layout_height="40dp"> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal"> // Item布局 <LinearLayout android:layout_width="140dp" android:layout_height="match_parent" android:orientation="horizontal"> // 功能按钮 </LinearLayout> </LinearLayout></com.yl.recyclerview.widget.SlideItemView>
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"?><shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle"> <size android:width="5dp" android:height="5dp" /> <solid android:color="@color/colorPrimary" /></shape>
作者:容华谢后
链接:https://www.jianshu.com/p/827769fc0290
点击查看更多内容
为 TA 点赞
评论
共同学习,写下你的评论
评论加载中...
作者其他优质文章
正在加载中
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦