YCRefreshView
- **自定义支持上拉加载更多，下拉刷新，支持自由切换状态【加载中，加载成功，加载失败，没网络等状态】的控件，拓展功能[支持长按拖拽，侧滑删除]可以选择性添加
。具体使用方法，可以直接参考demo。**
- 轻量级侧滑删除菜单，支持recyclerView，listView，直接嵌套item布局即可使用，整个侧滑菜单思路是：跟随手势将item向左滑动
- 该库已经用到了实际开发项目中，会持续更新并且修改bug。如果觉得可以，可以star一下，多谢支持！
- 感谢前辈大神们案例及开源分享精神。
- 一行代码集成：compile 'org.yczbj:YCRefreshViewLib:2.4'
- 项目地址：
- GitHub地址：
目录介绍
- 1.关于复杂页面封装库介绍
- 2.关于该开源库的思路
- 3.如何使用介绍
- 4.关于该状态切换工具优点分析
- 5.实现效果
- 6.版本更新说明
- 7.参考资料说明
1.关于复杂页面封装库介绍
- 1.1 支持上拉加载，下拉刷新，可以自定义foot底部布局，支持添加多个自定义header头部布局。
- 1.2 支持切换不同的状态，比如加载中[目前是ProgressBar，加载成功，加载失败，加载错误等不同布局状态。当然也可以自定义这些状态的布局
- 1.3 支持复杂界面使用，比如有的页面包含有轮播图，按钮组合，横向滑动，还有复杂list，那么用这个控件就可以搞定。
- 1.4 已经用于实际开发项目投资界，新芽，沙丘大学中……
- 1.5 轻量级侧滑删除菜单，直接嵌套item布局即可使用，使用十分简单。
- 1.6 支持插入或者删除某条数据，支持CoordinatorLayout炫酷的效果
- 1.7 支持粘贴头部的需求效果
- 1.8 RecyclerView实现条目Item拖拽排序与滑动删除
- 1.9 更多内容可以直接看案例代码
2.关于该开源库的思路
- 2.0 参考并借鉴了大量的优秀开源库，由于后期业务需求发生变化，因此做了一些功能的延伸与定制。继续完善并修改库bug！！！已经用于实际开发中。
- 2.1 先来看看布局，实际上只是在recyclerView基础上做了大量拓展……
3.如何使用介绍
- 3.1 首先在集成：compile 'org.yczbj:YCRefreshViewLib:2.4'
- 3.2 在布局中：
- 3.3 在代码中
recyclerView.setLayoutManager(new FullyGridLayoutManager(activity, 3)); adapter = new DouBookAdapter(activity); recyclerView.setAdapter(adapter); //加载更多 adapter.setMore(R.layout.view_recycle_more, new RecyclerArrayAdapter.OnMoreListener() { @Override public void onMoreShow() { if (NetworkUtils.isConnected()) { if (adapter.getAllData().size() > 0) { getTopMovieData(mType, adapter.getAllData().size(), adapter.getAllData().size() + 21); } else { adapter.pauseMore(); } } else { adapter.pauseMore(); Toast.makeText(activity, "网络不可用", Toast.LENGTH_SHORT).show(); } } @Override public void onMoreClick() { } }); //设置没有数据 adapter.setNoMore(R.layout.view_recycle_no_more, new RecyclerArrayAdapter.OnNoMoreListener() { @Override public void onNoMoreShow() { if (NetworkUtils.isConnected()) { adapter.resumeMore(); } else { Toast.makeText(activity, "网络不可用", Toast.LENGTH_SHORT).show(); } } @Override public void onNoMoreClick() { if (NetworkUtils.isConnected()) { adapter.resumeMore(); } else { Toast.makeText(activity, "网络不可用", Toast.LENGTH_SHORT).show(); } } }); //设置错误 adapter.setError(R.layout.view_recycle_error, new RecyclerArrayAdapter.OnErrorListener() { @Override public void onErrorShow() { adapter.resumeMore(); } @Override public void onErrorClick() { adapter.resumeMore(); } }); //刷新 recyclerView.setRefreshListener(new SwipeRefreshLayout.OnRefreshListener() { @Override public void onRefresh() { if (NetworkUtils.isConnected()) { getTopMovieData(mType , 0 , 30); } else { recyclerView.setRefreshing(false); Toast.makeText(activity, "网络不可用", Toast.LENGTH_SHORT).show(); } } }); - 3.4 如何使用侧滑菜单删除功能呢？
- 3.4.1 在布局文件中
- 3.4.2 在代码中设置
- 在adapter中定义接口
private OnSwipeMenuListener listener; public void setOnSwipeMenuListener(OnSwipeMenuListener listener) { this.listener = listener; } - 在adapter设置点击事件
View.OnClickListener clickListener = new View.OnClickListener() { @Override public void onClick(View v) { switch (v.getId()){ case R.id.btn_del: if (null != listener) { listener.toDelete(getAdapterPosition()); } break; case R.id.btn_top: if (null != listener) { listener.toTop(getAdapterPosition()); } break; } }};btn_del.setOnClickListener(clickListener);btn_top.setOnClickListener(clickListener); - 处理置顶或者删除的功能
adapter.setOnSwipeMenuListener(new OnSwipeMenuListener() { //删除功能 @Override public void toDelete(int position) { adapter.getAllData().remove(position); adapter.notifyItemRemoved(position);//推荐用这个 } //置顶功能 @Override public void toTop(int position) { //先移除那个位置的数据，然后将其添加到索引为0的位置，然后刷新数据 if (position > 0 && adapter.getAllData().size()>position) { Person person = adapter.getAllData().get(position); adapter.getAllData().remove(person); adapter.notifyItemInserted(0); adapter.getAllData().add(0, person); adapter.notifyItemRemoved(position + 1); if (linearLayoutManager.findFirstVisibleItemPosition() == 0) { recyclerView.scrollToPosition(0); } } }}); - 处理长按拖拽，滑动删除的功能。轻量级，自由选择是否实现。
mCallback = new DefaultItemTouchHelpCallback(new DefaultItemTouchHelpCallback.OnItemTouchCallbackListener() { @Override public void onSwiped(int adapterPosition) { // 滑动删除的时候，从数据库、数据源移除，并刷新UI if (personList != null) { personList.remove(adapterPosition); adapter.notifyItemRemoved(adapterPosition); } } @Override public boolean onMove(int srcPosition, int targetPosition) { if (personList != null) { // 更换数据库中的数据Item的位置 boolean isPlus = srcPosition < targetPosition; // 更换数据源中的数据Item的位置 Collections.swap(personList, srcPosition, targetPosition); // 更新UI中的Item的位置，主要是给用户看到交互效果 adapter.notifyItemMoved(srcPosition, targetPosition); return true; } return false; }});mCallback.setDragEnable(true);mCallback.setSwipeEnable(true);ItemTouchHelper itemTouchHelper = new ItemTouchHelper(mCallback);itemTouchHelper.attachToRecyclerView(recyclerView); 4.关于该状态切换工具优点分析
- 4.1 不仅可以实现上拉加载，下拉刷新。还可以根据获取数据来切换页面的状态，可以自定义状态页面，如下所示：
//设置加载中recyclerView.showProgress();//设置有数据展示recyclerView.showRecycler();//设置为空recyclerView.setEmptyView(R.layout.view_custom_empty_data);recyclerView.showEmpty();//设置错误recyclerView.setErrorView(R.layout.view_custom_data_error);recyclerView.showError();LinearLayout ll_error_view = (LinearLayout) recyclerView.findViewById(R.id.ll_error_view);ll_error_view.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { }});//设置网络错误recyclerView.setErrorView(R.layout.view_custom_network_error);recyclerView.showError();LinearLayout ll_set_network = (LinearLayout) recyclerView.findViewById(R.id.ll_set_network);ll_set_network.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { if(NetworkUtils.isConnected()){ initData(); }else { Intent intent = new Intent(Settings.ACTION_WIRELESS_SETTINGS); startActivity(intent); } }}); 5.实现效果
5.1 使用过YCRefreshView库的案例代码
- 可以直接参考demo，或者直接参考的我其他案例，其中这几个案例中使用到了该库
5.2 图片展示效果
- demo效果图展示
- 案例图展示
6.版本更新说明
- v1.0 更新于2017年4月22日
- v1.1 更新于2017年8月9日
- v1.…… 更新于2018年1月5日
- v2.2 更新于2018年1月17日
- v2.3 更新于2018年2月9日
- v2.4 更新于2018年3月19日
7.参考资料说明
- 非常感谢前辈大神的封装思路和代码案例，感谢！！！
- 具体的使用可以直接参考Demo案例，非常感谢Jude大神的开源项目！
- BGARefreshLayout-Android：
- Android-PullToRefresh：
- Jude95/EasyRecyclerView：
- 严正杰大神， RecyclerView实现条目Item拖拽排序与滑动删除：