封面
轉(zhuǎn)載請(qǐng)注明出處：http://www.itdecent.cn/p/827769fc0290
本文出自 容華謝后的博客
1.寫(xiě)在前面
2019年的第一篇文章，分享一個(gè)自己寫(xiě)的開(kāi)源項(xiàng)目，主要是對(duì)RecyclerView控件的一些常用功能封裝， 包括（上拉加載更多、頭尾布局、拖拽排序、側(cè)滑刪除、側(cè)滑選擇、萬(wàn)能分割線）。
RecyclerViewHelper主要使用了裝飾者模式對(duì)項(xiàng)目原有的Adapter進(jìn)行功能擴(kuò)展，不會(huì)影響項(xiàng)目的原有結(jié)構(gòu)，集成和修改都非常方便，一起來(lái)看下。
2.引入依賴庫(kù)
- 在項(xiàng)目根目錄的build.gradle文件中加入如下代碼：
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
- 在app根目錄的buil.gradle文件中加入依賴：
dependencies {
implementation 'com.github.alidili:RecyclerViewHelper:1.0.0'
}
截止此篇文章發(fā)布時(shí)，最新版本為1.0.0，最新版本可在GitHub中查看。
RecyclerViewHelper中使用的RecyclerView版本如下：
implementation "androidx.recyclerview:recyclerview:1.0.0"
3.上拉加載更多
效果圖：
上拉加載更多
集成：
// CommonAdapter為項(xiàng)目原有Adapter
CommonAdapter commonAdapter = new CommonAdapter(mDataList);
mLoadMoreWrapper = new LoadMoreWrapper(commonAdapter);
// 自定義加載布局
customLoadingView();
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(mLoadMoreWrapper);
// 設(shè)置上拉加載監(jiān)聽(tīng)
mRecyclerView.addOnScrollListener(new OnScrollListener() {
@Override
public void onLoadMore() {
// 設(shè)置數(shù)據(jù)正在加載狀態(tài)，可自定義布局
mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING);
if (mDataList.size() < 52) {
// 獲取數(shù)據(jù)
// 設(shè)置數(shù)據(jù)加載完成狀態(tài)，可自定義布局
mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING_COMPLETE);
} else {
// 設(shè)置所有數(shù)據(jù)加載完成狀態(tài)，可自定義布局
mLoadMoreWrapper.setLoadStateNotify(mLoadMoreWrapper.LOADING_END);
}
}
});
// 刷新數(shù)據(jù)需要使用外層Adapter
mLoadMoreWrapper.notifyDataSetChanged();
自定義加載布局：
private void customLoadingView() {
// 正在加載布局
ProgressBar progressBar = new ProgressBar(this);
mLoadMoreWrapper.setLoadingView(progressBar);
// 所有數(shù)據(jù)加載完成布局
TextView textView = new TextView(this);
textView.setText("End");
mLoadMoreWrapper.setLoadingEndView(textView);
// 布局高度
mLoadMoreWrapper.setLoadingViewHeight(DensityUtils.dp2px(this, 50));
}
4.頭尾布局
效果圖：
頭尾布局
集成：
// CommonAdapter為項(xiàng)目原有Adapter
CommonAdapter commonAdapter = new CommonAdapter(mDataList);
mHeaderAndFooterWrapper = new HeaderAndFooterWrapper(commonAdapter);
// 添加頭尾布局
addHeaderAndFooterView();
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(mHeaderAndFooterWrapper);
// 刷新數(shù)據(jù)需要使用外層Adapter
mHeaderAndFooterWrapper.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為項(xiàng)目原有Adapter
CommonAdapter commonAdapter = new CommonAdapter(mDataList);
// 拖拽事件響應(yīng)時(shí)間默認(rèn)為200ms，可自定義
mDragAndDropWrapper = new DragAndDropWrapper(commonAdapter, mDataList, 200);
mDragAndDropWrapper.attachToRecyclerView(mRecyclerView, true);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(mDragAndDropWrapper);
// 刷新數(shù)據(jù)需要使用外層Adapter
mDragAndDropWrapper.notifyDataSetChanged();
6.側(cè)滑刪除
效果圖：
側(cè)滑刪除
集成：
// CommonAdapter為項(xiàng)目原有Adapter
CommonAdapter commonAdapter = new CommonAdapter(mDataList);
mSwipeToDismissWrapper = new SwipeToDismissWrapper(commonAdapter, mDataList);
mSwipeToDismissWrapper.attachToRecyclerView(mRecyclerView);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(mSwipeToDismissWrapper);
// 設(shè)置刪除事件監(jiān)聽(tīng)
mSwipeToDismissWrapper.setItemDismissListener(new ItemSwipeCallback.ItemDismissListener() {
@Override
public void onItemDismiss(final int position) {
// TODO
}
});
// 刷新數(shù)據(jù)需要使用外層Adapter
mSwipeToDismissWrapper.notifyDataSetChanged();
7.側(cè)滑選擇
效果圖：
側(cè)滑選擇
集成：
<?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，也可以配合其他控件或者單獨(dú)使用。
8.萬(wàn)能分割線
效果圖：
萬(wàn)能分割線
集成：
// CommonAdapter為項(xiàng)目原有Adapter
mDividerAdapter = new DividerAdapter(mDataList);
LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
mRecyclerView.setLayoutManager(linearLayoutManager);
// 設(shè)置分割線
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>
9.寫(xiě)在最后
到這里，RecyclerViewHelper的基本功能就介紹完了，如有問(wèn)題可以給我留言評(píng)論或者在GitHub中提交Issues，謝謝！
RecyclerViewHelper項(xiàng)目后續(xù)還會(huì)增加更多常用功能，Kotlin版本正在開(kāi)發(fā)中，敬請(qǐng)期待！
