笔记28 | 学习一个简单好用的下拉刷新、上拉加载控件
地址
http://blog.csdn.net/xiangyong_1521/article/details/78431139
目录
- 前言
- 基本用法
- API拓展
- 显示细节补充和实现
- 附
前言
一个支持网络错误重试、无数据页（可自定义）、无网络界面（可自定义）的上拉加载更多，下拉刷新控件。
基本用法
1. 添加依赖库
compile 'com.zt.maven.widget:refreshview:1.0.0'2. 初始化控件
动态加载刷新的空间，listview，xml...
3. 调用
refreshView.setOnLoadListener(new CustomRefreshView.OnLoadListener() {
@Override
public void onRefresh() {
//下拉刷新，添加你刷新后的逻辑
//加载完成时，隐藏控件下拉刷新的状态
refreshView.complete();
}
@Override
public void onLoadMore() {
//上拉加载更多，添加你加载数据的逻辑
//加载完成时，隐藏控件上拉加载的状态
refreshView.complete();
}
});API拓展
1.自动刷新
在上方法3后加： refreshView.setRefreshing(true);2.“无数据界面”添加
如果首次刷新无数据，则需要显示无数据的界面，可以在你加载完成时，根据后端接口返回的数据（一定是请求第一页且返回无数据的情况下）添加相应的界面（上图gif中的“暂无数据”界面即控件中默认的”码1“，自定义的话只需把你的无数据界面写好，api调用时当作参数传递即可”码2“），并且依旧可以下拉刷新。
码1：refreshView.setEmptyView("暂无数据");码2：refreshView.setCreateView(customView);3.”无网络或加载失败界面“添加
如果项目中需要在无网络或者加载失败的情况下（根据接口数据返回）添加相应的ui给用户一个友好的交互，那么你可以直接调用，当然也可以写自己风格的ui
3.1. 使用引入控件中的默认加载失败（无网络）界面-效果如上图gif的重试界面
refreshView.setErrorView();3.2. 使用自己写的加载失败（无网络）界面，这里的“重试按钮点击进行重新加载"的过程你只需在你的点击事件中加入
refreshView.setRefreshing(true);4.加载失败重试机制
如果项目中需要支持加载失败时重试机制（这里指已经加载出数据但是在加载下一页数据失败时，点击底部变更的ui进行加载，详见上图gif加载更多时显示点击重试），当然控件也满足需求，调用时需要判断是否时大于第一页（注：有的公司接口规定从0开始，有的从1开始），这里还有一点要注意：如果当前不是首页的情况下加载失败，你需要将你的页码数减一，否则会跳过本页数据展示，用法如下：
@Override
public void onFail(TinaException exception) {
if (m > 1) {//m标记着是否是第一页数据,如果大于第一页时，页面数要减一，以保证数据不会遗漏加载
size = size - 1;
refreshView.onError();//处理加载失败的ui显示和点击ui重新加载的机制
} else {
refreshView.setErrorView();//当第一页数据加载失败时显示的占位
}
refreshView.complete();//表示隐藏刷新的ui
}5.加载完成状态，显示”-- 没有更多了 --“
refreshView.onNoMore();显示细节补充和实现
1. 控件默认支持线性布局
2. 变更下拉刷新的ui圆圈颜色
refreshView.getSwipeRefreshLayout().setColorSchemeColors(getResources().getColor());3 禁止下拉刷新
refreshView.setRefreshEnable(false);4. 禁止加载更多
refreshView.setLoadMoreEnable(false);