ByRecyclerView 是基于RecyclerView的扩展,提供了上拉刷新、加载更多、 添加HeaderView/FooterView、setStateView、item点击/长按监听、万能分割线、粘性header、极简Adapter(databinding)等功能,有效的解决了XRecyclerView和BRVAH其中的问题。
- 1.支持 下拉刷新、加载更多
- 2.可随意切换 自带下拉刷新布局 / SwipeRefreshLayout
- 3.加载更多机制:不足一屏上拉加载,超过后触底加载(所见即所得)
- 4.可设置 自定义 下拉刷新布局 和 加载更多布局
- 5.可Add HeaderView、FooterView
- 6.可设置 StateView状态布局
- 7.可添加 item及子view的点击/长按事件
- 8.优化过的BaseAdapter (RecyclerView / ListView),减少大量代码
- 9.Adapter结合DataBinding使用 (RecyclerView / ListView)
- 10.可添加 万能分隔线(LinearLayout / GridLayout / StaggeredGridLayout)
- 11.可配置 粘性header,StickyView
- 12.可配置 Skeleton骨架图
- 13.默认使用AndoridX,且支持Support
刷新操作 | 设置状态布局 | 多类型列表 | 万能分割线 |
---|---|---|---|
![]() |
![]() |
![]() |
![]() |
如何使用 👉 Wiki文档
1.先在 build.gradle 的 repositories 添加
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
2.然后在dependencies添加
dependencies {
implementation 'com.github.youlookwhat:ByRecyclerView:1.0.17' // AndroidX版本引入
implementation "com.github.youlookwhat:ByRecyclerView:1.0.17-support" // support版本引入
}
3.在XML布局中引用 ByRecyclerView
<me.jingbin.library.ByRecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:layoutManager="LinearLayoutManager"
tools:listitem="@layout/item_main" />
4.使用BaseRecyclerAdapter
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(new BaseRecyclerAdapter<String>(R.layout.item_main, list) {
@Override
protected void bindView(BaseByViewHolder<String> holder, String bean, int position) {
holder.setText(R.id.tv_text, bean);
}
});
mAdapter.setNewData(list); // 设置第一页数据
5.设置监听
// 下拉刷新监听
mRecyclerView.setOnRefreshListener(new ByRecyclerView.OnRefreshListener() {
@Override
public void onRefresh() {
// 刷新完成
mRecyclerView.setRefreshing(false);
}
});
// 加载更多监听
mRecyclerView.setOnLoadMoreListener(new ByRecyclerView.OnLoadMoreListener() {
@Override
public void onLoadMore() {
mAdapter.addData(list); // 设置及刷新数据
mRecyclerView.loadMoreComplete(); // 加载更多完成
mRecyclerView.loadMoreEnd(); // 没有更多内容了
mRecyclerView.loadMoreFail(); // 加载更多失败,点击重试
}
});
万能分割线,可给Linear/Grid/StaggeredGrid设置,并可配置去除不显示分割线的头部和尾部个数
1.给LinearLayout设置分割线
// 选择1:设置drawable
SpacesItemDecoration itemDecoration = new SpacesItemDecoration(this, SpacesItemDecoration.VERTICAL)
.setNoShowDivider(1, 1) // 第一个参数:头部不显示分割线的个数,第二个参数:尾部不显示分割线的个数,默认为1
.setDrawable(R.drawable.shape_line);// 设置drawable文件
// 选择2:设置颜色、高度、间距等
SpacesItemDecoration itemDecoration = new SpacesItemDecoration(this, SpacesItemDecoration.VERTICAL)
.setNoShowDivider(1, 1)
// 颜色,分割线间距,左边距(单位dp),右边距(单位dp)
.setParam(R.color.colorBlue, 10, 70, 70);
recyclerView.addItemDecoration(itemDecoration);
2.给宫格/瀑布流设置分割线
// 3:每行个数; 10:间距; true:距屏幕周围是否也有间距
GridSpaceItemDecoration itemDecoration = new GridSpaceItemDecoration(3, 10, true)
.setNoShowSpace(1, 1);// 第一个参数:头部不显示分割线的个数,第二个参数:尾部不显示分割线的个数,默认为1
recyclerView.addItemDecoration(itemDecoration);
// 获取view对应databinding,注意:recyclerView.getParent()
LayoutHeaderViewBinding headerBinding = DataBindingUtil.inflate(LayoutInflater.from(this), R.layout.layout_header_view, (ViewGroup) binding.recyclerView.getParent(), false);
recyclerView.addHeaderView(headerBinding.getRoot());
recyclerView.addFooterView(getView() / layoutId));
recyclerView.setStateView(getView() / layoutId);
// headerView、footerView、setStateView 支持一键隐藏,设置后需要notify
recyclerView.setHeaderViewEnabled(false);
recyclerView.setFootViewEnabled(false);
recyclerView.setStateViewEnabled(false);
mRecyclerView.setOnItemClickListener(new ByRecyclerView.OnItemClickListener() {
@Override
public void onClick(View v, int position) {
// 通过adapter获取对应position的数据
DataItemBean itemData = mAdapter.getItemData(position);
}
});
mRecyclerView.setOnItemLongClickListener(new ByRecyclerView.OnItemLongClickListener() {
@Override
public boolean onLongClick(View v, int position) {
return false;
}
});
// 添加 子View的点击/长按事件
holder.addOnClickListener(R.id.tv_text);
holder.addOnLongClickListener(R.id.tv_text);
recyclerView.setOnItemChildClickListener(new ByRecyclerView.OnItemChildClickListener() {
@Override
public void onItemChildClick(View view, int position) {
}
});
recyclerView.setOnItemChildLongClickListener(new ByRecyclerView.OnItemChildLongClickListener() {
@Override
public void onItemChildLongClick(View view, int position) {
}
});
// 1、使用StickyLinearLayoutManager,传入adapter
StickyLinearLayoutManager layoutManager = new StickyLinearLayoutManager(getContext(), mAdapter);
// 2、在adapter里,将悬浮的item的ItemViewType设置为StickyHeaderHandler.TYPE_STICKY_VIEW
@Override
public int getItemViewType(int position) {
if ("title".equals(getItemData(position).getType())) {
return StickyHeaderHandler.TYPE_STICKY_VIEW;
} else {
return 2;
}
}
1.设置item骨架图
// 显示
skeletonScreen = BySkeleton
.bindItem(binding.recyclerView)
.adapter(mAdapter)// 必须设置adapter,且在此之前不要设置adapter
.shimmer(false)// 是否有动画
.load(R.layout.layout_by_default_item_skeleton)// item骨架图
.angle(30)// 微光角度
.frozen(false) // 是否不可滑动
.color(R.color.colorWhite)// 动画的颜色
.duration(1500)// 微光一次显示时间
.count(10)// item个数
.show();
// 隐藏
skeletonScreen.hide();
2.设置view骨架图
// 显示
skeletonScreen = BySkeleton
.bindView(binding.recyclerView)
.load(R.layout.layout_skeleton_view)// view骨架图
.shimmer(true)// 是否有动画
.angle(20)// 微光角度
.color(R.color.colorWhite)// 动画的颜色
.duration(1500)// 微光一次显示时间
.show();
// 隐藏
skeletonScreen.hide();
ByRecyclerView | BRVAH | XRecyclerView | |
---|---|---|---|
下拉刷新布局 | 继承基类自定义布局 | 无 | 只能简单设置样式 |
SwipeRefreshLayout | 可配合使用 | 可配合使用 | 不能使用 |
加载更多布局 | 继承基类自定义布局 | 继承基类设置简单布局 | 继承基类自定义类 |
加载更多机制 | 不足一屏上拉加载,超过后触底加载 | 不足一屏即加载 | 触底加载 |
HeaderView | 多ViewType区别 | 同一个item | 多ViewType区别 |
FooterView | 同一个item | 同一个item | 不能添加 |
EmptyView | 可设置 | 可设置 | 不能设置 |
点击/长按事件 | 有 | 有 | 无 |
ByRecyclerView 是XRecyclerView的拓展,可完全替换XRecyclerView,对于BRVAH它的优势在于:
- headerView使用的是多type的形式,即一个header就是一个position
- 不足一屏上拉加载,超过后触底加载
- 自带下拉加载布局,也可使用三方刷新框架,比如SwipeRefreshLayout
- 万能分割线(LinearLayout / GridLayout / StaggeredGridLayout)
- 可设置悬浮置顶item StickyView
- 可设置Skeleton 骨架图
缺点是还没有BRVAH里的部分功能,比如分组adapter、DiffUtils、item扩展动画...后期会逐步完善。
此资源库没有使用到任何序列化、反序列化、JNI、反射,无需进行额外的混淆操作,并且已经测试通过,在实际项目中使用,如果你在项目混淆之后出现问题,请及时联系我。
大家可以加群讨论使用本库时出现的问题,也可以直接提Issues,我会第一时间帮助大家解决。如果此库帮助到了你,还请给个Star、Fork一下,我将更有动力持续迭代优化,非常感谢^_^。
- QQ: 770413277
- 掘金:Jinbeen
- CSDN:Jinbeen
- Email: jingbin127@163.com
Copyright (C) 2016 Bin Jing
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.