简介
主要提供了简单易用强大的RecyclerView库,包括自定义刷新加载效果、极简通用的万能适配器Adapter、万能分割线、多种分组效果、常见状态页面、item动画效果、添加多个header和footer、侧滑、拖拽、Sticky(黏性)效果、多item布局等,各模块之间灵活、解耦、通用、又能相互组合使用。
功能
- 优化RecyclerView功能
- 支持刷新和加载更多效果,滑动到底部自动加载下页数据
- 支持自定义刷新和加载更多效果
- 支持添加多个header和footer,一行代码搞定
- 支持动态加载各种Item类型的列表、网格、瀑布流
- 支持极简通用的万能适配器Adapter,可以接受任意数据实体
- 支持万能的分割线、设置高度(宽度)、颜色、自定义等
- 支持点击和长按效果
- 支持Item加载动画效果
- 支持各种分组、随心定义分组头部、尾部、多类型内容item
- 支持侧滑、拖拽
- 支持Sticky(黏性)效果
- 支持多item布局
- 支持状态页面,加载中、空页面、错误页面、内容页面切换
- 支持自定义万能adapter、holder
演示
XRecyclerView使用介绍
XRecyclerView基于RecyclerView的封装,在原有功能的基础上支持刷新、加载更多、自定义刷新加载更多、添加头部、尾部等
添加(单个/多个)HeaderViw、FooterView
可以添加单个或者多个普通HeaderViw、FooterView,支持内容为LinearLayoutManager和GridLayoutManager。
方式一:
//添加一个头部view
mRecyclerView.addHeaderView(new SampleHeader(this));
//mRecyclerView.addHeaderView(new SampleHeader2(this));//添加第二个头部view
....
//mRecyclerView.addHeaderView(new SampleHeaderN(this));//添加第n个头部view(多头部)
//添加一个尾部view
mRecyclerView.addFooterView(new SampleFooter(this));
//mRecyclerView.addFooterView(new SampleFooter2(this));//添加第二个尾部view
....
//mRecyclerView.addFooterView(new SampleFooterN(this));//添加第n个尾部view(多尾部)
方式二:
//添加一个头部view
View headerView = LayoutInflater.from(this).inflate(R.layout.layout_header, (ViewGroup)findViewById(android.R.id.content),false);
mRecyclerView.addHeaderView(headerView);
//mRecyclerView.addHeaderView(headerView2);//添加第二个头部view
...
//mRecyclerView.addHeaderView(headerViewN);//添加第n个头部view(多头部)
//点击事件
headerView.findViewById(R.id.test_txt).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
...
}
});
//添加一个尾部view
View footerView = getLayoutInflater().inflate(R.layout.layout_footer, (ViewGroup) mRecyclerView.getParent(), false);
mRecyclerView.addFooterView(footerView);
//mRecyclerView.addFooterView(footerView2);//添加第二个尾部view
....
//mRecyclerView.addFooterView(footerViewN);//添加第n个尾部view(多尾部)
//点击事件
footerView.findViewById(R.id.test_txt).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
...
}
});
注:此功能只是添加普通的头部和尾部,与刷新和加载更多的头部和尾部是不一样的,切记!不会影响刷新头和加载更多尾部的显示问题
移除HeaderViw、FooterView
//移除添加的头部view
mRecyclerView.removeHeaderView(headerView);
//移除添加的尾部view
mRecyclerView.removeFooterView(footerView);
下拉刷新和加载更多样式
//设置下拉刷新Progress的样式
mRecyclerView.setRefreshProgressStyle(ProgressStyle.BallSpinFadeLoader); //在ProgressStyle里面选择喜欢的样式
//设置下拉刷新箭头
mRecyclerView.setArrowImageView(R.drawable.iconfont_downgrey);
//设置加载更多Progress的样式
mRecyclerView.setLoadingMoreProgressStyle(ProgressStyle.BallPulse);
注:1.如果采用自定义下拉刷新setRefreshHeader()和加载更多setLoadingMoreFoote(),以上设置会不起作用,也无须设置。
开启和禁止下拉刷新、加载更多功能
//打开刷新和加载更多
mRecyclerView.setPullRefreshEnabled(true);
mRecyclerView.setLoadingMoreEnabled(true);
注:默认是开启。
设置底部加载文字提示
mRecyclerView.setFootViewText("拼命加载中","已经全部");
注:自定义加载更多View时,此设置不起作用,切记!
下拉刷新完成
mRecyclerView.refreshComplete();
上拉加载更多完成
mRecyclerView.loadMoreComplete();
数据加载完成
mRecyclerView.setNoMore(true);
开启进入页面自动刷新
mRecyclerView.setRefreshing(true);//没有更多数据
例:在Acitvity中开启进入页面自动刷新,在onStart()中处理。
@Override
protected void onStart() {
super.onStart();
if(mRecyclerView !=null){
mRecyclerView.setRefreshing(true);
}
}
自定义下拉刷新View
- 自定义view继承BaseRefreshHeader;
- 调用setRefreshHeader(IRefreshHeader refreshHeader)即可。
mRecyclerView.setRefreshHeader(new CustomRefreshHeader(this));
示例:
public class CustomRefreshHeader extends BaseRefreshHeader {
private CustomAnimView mCustomAnimView;
public CustomRefreshHeader2(Context context) {
super(context);
}
public CustomRefreshHeader2(Context context, AttributeSet attrs) {
super(context, attrs);
}
@Override
public View getView() {
//方式一
mCustomAnimView = new CustomAnimView(getContext());
return mCustomAnimView;
//方式二
//return LayoutInflater.from(getContext()).inflate(R.layout.clife_loading_header,null);
}
//根据状态改变View
@Override
public void setState(int state) {
super.setState(state);
//选择自定义需要处理的状态:STATE_NORMAL、STATE_RELEASE_TO_REFRESH、STATE_REFRESHING、STATE_DONE
//以下是我自定义动画需要用到的状态判断,你可以根据自己需求选择。
if (state == STATE_REFRESHING) { // 显示进度
//这里处理自己的逻辑、刷新中
mCustomAnimView.startAnim();
} else if (state == STATE_DONE) {
//这里处理自己的逻辑、刷新完成
mCustomAnimView.stopAnim();
} else {
mCustomAnimView.startAnim();
}
}
/* @Override
public void refreshComplete() {
//有默认处理、可以覆盖该方法处理,刷新完成的动作
}*/
/*@Override
public void smoothScrollTo(int destHeight) {
//super.smoothScrollTo(destHeight);
//有默认处理、可以覆盖该方法处理,顺滑改变高度
}*/
//更多方法,可以通过覆写实现,自定义
}
注:如果设置了自定义下拉刷新,setRefreshProgressStyle()会不起作用,无需配置,要么采用库里默认支持的样式设置,要么采用自定义View。
自定义加载更多View
- 自定义view实现BaseMoreFooter接口;
- 调用setLoadingMoreFooter(IMoreFooter refreshHeader)即可。
mRecyclerView.setLoadingMoreFooter(new CustomMoreFooter(this));
示例:
public class CustomMoreFooter extends BaseMoreFooter {
private AnimationDrawable mAnimationDrawable;
private LinearLayout allLayout;
private TextView mTextView;
public CustomMoreFooter(Context context) {
super(context);
}
public CustomMoreFooter(Context context, AttributeSet attrs) {
super(context, attrs);
}
@Override
protected void initView() {
super.initView();//有居中显示功能,如果不需要就去掉super.initView();
allLayout = (LinearLayout) LayoutInflater.from(getContext()).inflate(R.layout.pull_to_refresh_clife, null);
ImageView imageView = (ImageView) allLayout.findViewById(R.id.lodimg);
imageView.setImageResource(R.drawable.icon_loading_animation);
mAnimationDrawable = (AnimationDrawable) imageView.getDrawable();
mTextView = (TextView) allLayout.findViewById(R.id.lodtext);
addView(allLayout);
}
@Override
public void setState(int state) {
super.setState(state);
//以下是我自定义动画需要用到的状态判断,你可以根据自己需求选择。
//选择自定义需要处理的状态:STATE_LOADING、STATE_COMPLETE、STATE_NOMORE、STATE_NOMORE
switch (state) {
case STATE_LOADING:
this.setVisibility(View.VISIBLE);
mAnimationDrawable.start();