Android|Android 智能刷新框架SmartRefreshLayout
SmartRefreshLayout是一个“聪明”或者“智能”的下拉刷新布局，由于它的“智能”，它不只是支持所有的View，还支持多层嵌套的视图结构。它继承自ViewGroup 而不是FrameLayout或LinearLayout，提高了性能。 也吸取了现在流行的各种刷新布局的优点，包括谷歌官方的 SwipeRefreshLayout，其他第三方的 Ultra-Pull-To-Refresh、TwinklingRefreshLayout 。还集成了各种炫酷的 Header 和 Footer。 SmartRefreshLayout的目标是打造一个强大，稳定，成熟的下拉刷新框架，并集成各种的炫酷、多样、实用、美观的Header和Footer。
SmartRefreshLayout官网
导入依赖
在build.gradle中添加依赖
//1.1.0 API改动过大，老用户升级需谨慎
compile 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-alpha-14'
compile 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-alpha-14'//没有使用特殊Header，可以不加这行
compile 'com.android.support:appcompat-v7:25.3.1'//版本 23以上（必须）//1.0.5 当1.1.0出现问题可以回退到1.0.5.1
compile 'com.scwang.smartrefresh:SmartRefreshLayout:1.0.5.1'
compile 'com.scwang.smartrefresh:SmartRefreshHeader:1.0.5.1'//没有使用特殊Header，可以不加这行
compile 'com.android.support:appcompat-v7:25.3.1'//版本 23以上（必须）
compile 'com.android.support:design:25.3.1'//版本随意（非必须，引用可以解决无法预览问题）
使用指定的Header和Footer
- 方法一：全局设置（优先级最低，会被下面两种方法取代)
public class App extends Application {
//static 代码段可以防止内存泄露
static {
//设置全局的Header构建器
SmartRefreshLayout.setDefaultRefreshHeaderCreator(new DefaultRefreshHeaderCreator() {
@Override
public RefreshHeader createRefreshHeader(Context context, RefreshLayout layout) {
layout.setPrimaryColorsId(R.color.colorPrimary, android.R.color.white);
//全局设置主题颜色
return new ClassicsHeader(context);
//.setTimeFormat(new DynamicTimeFormat("更新于 %s"));
//指定为经典Header，默认是 贝塞尔雷达Header
}
});
//设置全局的Footer构建器
SmartRefreshLayout.setDefaultRefreshFooterCreator(new DefaultRefreshFooterCreator() {
@Override
public RefreshFooter createRefreshFooter(Context context, RefreshLayout layout) {
//指定为经典Footer，默认是 BallPulseFooter
return new ClassicsFooter(context).setDrawableSize(20);
}
});
}
}
- 方法二 XML布局文件指定（优先级中等，会被方法三覆盖）
- 方法三 Java代码设置（优先级最高)
final RefreshLayout refreshLayout = (RefreshLayout) findViewById(R.id.refreshLayout);
//设置 Header 为 贝塞尔雷达 样式
refreshLayout.setRefreshHeader(new BezierRadarHeader(this).setEnableHorizontalDrag(true));
//设置 Footer 为 球脉冲 样式
refreshLayout.setRefreshFooter(new BallPulseFooter(this).setSpinnerStyle(SpinnerStyle.Scale));
各种效果和显示操作方式 1、默认使用
布局:根布局为LinearLayout，SmartRefreshLayout直接包裹一个RecyclerView
代码：设置刷新监听，下拉刷新功能默认是打开的：mRefreshLayout.setEnableRefresh(true);
RefreshLayout mRefreshLayout = findViewById(R.id.refreshLayout);
mRefreshLayout.setOnRefreshListener(new OnRefreshListener() {
@Override
public void onRefresh(@NonNull RefreshLayout refreshLayout) {
Listdata = https://www.it610.com/article/initDatas();
Message message = new Message();
message.what = 1 ;
message.obj = data ;
mHandler.sendMessageDelayed(message,2000);
}
});
设置加载监听，加载更多功能默认为关闭：mRefreshLayout.setEnableLoadMore(false); ，如果设置监听会打开加载更多功能：
RefreshLayout mRefreshLayout = findViewById(R.id.refreshLayout);
mRefreshLayout.setOnLoadMoreListener(new OnLoadMoreListener() {
@Override
public void onLoadMore(@NonNull RefreshLayout refreshLayout) {
Listdata = https://www.it610.com/article/initDatas();
Message message = new Message();
message.what = 2;
message.obj = data ;
mHandler.sendMessageDelayed(message,2000);
}
});
private Handler mHandler = new Handler(new Handler.Callback() {
@Override
public boolean handleMessage(Message msg) {
switch (msg.what){
case 1://刷新加载
List mList= (List) msg.obj;
mRefreshLayout.finishRefresh(true);
adapter.setDatas(mList);
break;
case 2://加载更多
List mLoadMoreDatas = (List) msg.obj;
mRefreshLayout.finishLoadMore(true);
adapter.addMoreValue(mLoadMoreDatas);
break;
}
return false;
}
});
显示的效果：
文章图片
刷新.png
文章图片
上拉加载.png 2、经典风格
布局
文章图片
经典效果.png
在其中可以根据需要进行各种属性设置；
注：在设置属性时，代码中针对文字大小使用的是sp，故有特殊需求的需要改变设置：
如不随系统字体大小改变的实现方式，或自己设置dp：((TextView)header.findViewById(ClassicsHeader.ID_TEXT_TITLE)).setTextSize(TypedValue.COMPLEX_UNIT_DIP,16);
3 FalsifyHeader 虚假的Header，用于 真正的 Header 在RefreshLayout外部时，使用本虚假的FalsifyHeader填充在RefreshLayout内部，具体使用方法参考纸飞机；
单独使用FalsifyHead的效果为在下拉时出现空白下拉布局，这个也是可以监听下拉滴：
文章图片
FalsifyFooter 上拉加载和Falsifyheader是一样的空白背景效果，是可以拉动监听的
4、自定义Header可以参考Demo中的使用-Custom
5、淘宝二楼header TwoLevelHeader，参考demo中实战-淘宝二楼
下面的为特殊样式header，需要引用：com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-alpha-14
6、飞行气球：DeliveryHeader
7、掉落盒子：DropBoxHeader
8、全屏水滴：WaveSwipeHeader
9、官方下拉Meterial：MaterialHeader
10、颜色闪烁渐变头：StoreHouseHeader
11、战争城市游戏头：FunGameBattleCityHeader
12、打砖块游戏：FunGameHitBlockHeader
13、弹出圆圈加载：BezierCircleHeader
14、冲上云霄：TaurusHeader
15、金色校园：PhoenixHeader
官网给的一些设置属性方法 【Android|Android 智能刷新框架SmartRefreshLayout】代码、xml设置和Classics的一些属性设置方法
SmartRefreshLayoutjava代码设置public class RefreshActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
//下面示例中的值等于默认值
RefreshLayout refreshLayout = (RefreshLayout)findViewById(R.id.refreshLayout);
refreshLayout.setPrimaryColorsId(R.color.colorPrimary, android.R.color.white);
refreshLayout.setDragRate(0.5f);
//显示下拉高度/手指真实下拉高度=阻尼效果
refreshLayout.setReboundDuration(300);
//回弹动画时长（毫秒）refreshLayout.setHeaderHeight(100);
//Header标准高度（显示下拉高度>=标准高度 触发刷新）
refreshLayout.setHeaderHeightPx(100);
//同上-像素为单位 （V1.1.0删除）
refreshLayout.setFooterHeight(100);
//Footer标准高度（显示上拉高度>=标准高度 触发加载）
refreshLayout.setFooterHeightPx(100);
//同上-像素为单位 （V1.1.0删除）refreshLayout.setFooterHeaderInsetStart(0);
//设置 Header 起始位置偏移量 1.0.5
refreshLayout.setFooterHeaderInsetStartPx(0);
//同上-像素为单位 1.0.5 （V1.1.0删除）
refreshLayout.setFooterFooterInsetStart(0);
//设置 Footer 起始位置偏移量 1.0.5
refreshLayout.setFooterFooterInsetStartPx(0);
//同上-像素为单位 1.0.5 （V1.1.0删除）refreshLayout.setHeaderMaxDragRate(2);
//最大显示下拉高度/Header标准高度
refreshLayout.setFooterMaxDragRate(2);
//最大显示下拉高度/Footer标准高度
refreshLayout.setHeaderTriggerRate(1);
//触发刷新距离 与 HeaderHeight 的比率1.0.4
refreshLayout.setFooterTriggerRate(1);
//触发加载距离 与 FooterHeight 的比率1.0.4refreshLayout.setEnableRefresh(true);
//是否启用下拉刷新功能
refreshLayout.setEnableLoadMore(false);
//是否启用上拉加载功能
refreshLayout.setEnableAutoLoadMore(true);
//是否启用列表惯性滑动到底部时自动加载更多
refreshLayout.setEnablePureScrollMode(false);
//是否启用纯滚动模式
refreshLayout.setEnableNestedScroll(false);
//是否启用嵌套滚动
refreshLayout.setEnableOverScrollBounce(true);
//是否启用越界回弹
refreshLayout.setEnableScrollContentWhenLoaded(true);
//是否在加载完成时滚动列表显示新的内容
refreshLayout.setEnableHeaderTranslationContent(true);
//是否下拉Header的时候向下平移列表或者内容
refreshLayout.setEnableFooterTranslationContent(true);
//是否上拉Footer的时候向上平移列表或者内容
refreshLayout.setEnableLoadMoreWhenContentNotFull(true);
//是否在列表不满一页时候开启上拉加载功能
refreshLayout.setEnableFooterFollowWhenLoadFinished(false);
//是否在全部加载结束之后Footer跟随内容1.0.4
refreshLayout.setEnableOverScrollDrag(false);
//是否启用越界拖动（仿苹果效果）1.0.4refreshLayout.setEnableScrollContentWhenRefreshed(true);
//是否在刷新完成时滚动列表显示新的内容 1.0.5
refreshLayout.srlEnableClipHeaderWhenFixedBehind(true);
//是否剪裁Header当时样式为FixedBehind时1.0.5
refreshLayout.srlEnableClipFooterWhenFixedBehind(true);
//是否剪裁Footer当时样式为FixedBehind时1.0.5refreshLayout.setDisableContentWhenRefresh(false);
//是否在刷新的时候禁止列表的操作
refreshLayout.setDisableContentWhenLoading(false);
//是否在加载的时候禁止列表的操作refreshLayout.setOnMultiPurposeListener(new SimpleMultiPurposeListener());
//设置多功能监听器
refreshLayout.setScrollBoundaryDecider(new ScrollBoundaryDecider());
//设置滚动边界判断
refreshLayout.setScrollBoundaryDecider(new ScrollBoundaryDeciderAdapter());
//自定义滚动边界refreshLayout.setRefreshHeader(new ClassicsHeader(context));
//设置Header
refreshLayout.setRefreshFooter(new ClassicsFooter(context));
//设置Footer
refreshLayout.setRefreshContent(new View(context));
//设置刷新Content（用于非xml布局代替addView）1.0.4refreshLayout.autoRefresh();
//自动刷新
refreshLayout.autoLoadMore();
//自动加载
refreshLayout.autoRefresh(400);
//延迟400毫秒后自动刷新
refreshLayout.autoLoadMore(400);
//延迟400毫秒后自动加载
refreshLayout.finishRefresh();
//结束刷新
refreshLayout.finishLoadMore();
//结束加载
refreshLayout.finishRefresh(3000);
//延迟3000毫秒后结束刷新
refreshLayout.finishLoadMore(3000);
//延迟3000毫秒后结束加载
refreshLayout.finishRefresh(false);
//结束刷新（刷新失败）
refreshLayout.finishLoadMore(false);
//结束加载（加载失败）
refreshLayout.finishLoadMoreWithNoMoreData();
//完成加载并标记没有更多数据 1.0.4
refreshLayout.closeHeaderOrFooter();
//关闭正在打开状态的 Header 或者 Footer（1.1.0）
refreshLayout.resetNoMoreData();
//恢复没有更多数据的原始状态 1.0.4（1.1.0删除）
refreshLayout.setNoMoreData(false);
//恢复没有更多数据的原始状态 1.0.5}
}//全局一次性设置默认属性和默认Header
public class App extends Application {
static {//使用static代码段可以防止内存泄漏//设置全局默认配置（优先级最低，会被其他设置覆盖）
SmartRefreshLayout.setDefaultRefreshInitializer(new DefaultRefreshInitializer() {
@Override
public void initialize(@NonNull Context context, @NonNull RefreshLayout layout) {
//开始设置全局的基本参数（可以被下面的DefaultRefreshHeaderCreator覆盖）
layout.setReboundDuration(1000);
layout.setReboundInterpolator(new DropBounceInterpolator());
layout.setFooterHeight(100);
layout.setDisableContentWhenLoading(false);
layout.setPrimaryColorsId(R.color.colorPrimary, android.R.color.white);
}
});
//全局设置默认的 Header
SmartRefreshLayout.setDefaultRefreshHeaderCreator(new DefaultRefreshHeaderCreator() {
@Override
public RefreshHeader createRefreshHeader(Context context, RefreshLayout layout) {
//开始设置全局的基本参数（这里设置的属性只跟下面的MaterialHeader绑定，其他Header不会生效，能覆盖DefaultRefreshInitializer的属性和Xml设置的属性）
layout.setEnableHeaderTranslationContent(false);
return new MaterialHeader(context).setColorSchemeResources(R.color.colorRed,R.color.colorGreen,R.color.colorBlue);
}
});
}
}xml代码设置ClassicsHeaderjava代码设置public class RefreshActivity extends Activity {
static {
ClassicsHeader.REFRESH_HEADER_PULLDOWN = "下拉可以刷新";
ClassicsHeader.REFRESH_HEADER_REFRESHING = "正在刷新...";
ClassicsHeader.REFRESH_HEADER_LOADING = "正在加载...";
ClassicsHeader.REFRESH_HEADER_RELEASE = "释放立即刷新";
ClassicsHeader.REFRESH_HEADER_FINISH = "刷新完成";
ClassicsHeader.REFRESH_HEADER_FAILED = "刷新失败";
ClassicsHeader.REFRESH_HEADER_SECONDARY = "释放进入二楼";
ClassicsHeader.REFRESH_HEADER_LASTTIME = "上次更新 M-d HH:mm";
ClassicsHeader.REFRESH_HEADER_LASTTIME = "'Last update' M-d HH:mm";
}
@Override
protected void onCreate(Bundle savedInstanceState) {
ClassicsHeader.REFRESH_HEADER_PULLDOWN = getString(R.string.header_pulldown);
//"下拉可以刷新";
ClassicsHeader.REFRESH_HEADER_REFRESHING = getString(R.string.header_refreshing);
//"正在刷新...";
ClassicsHeader.REFRESH_HEADER_LOADING = getString(R.string.header_loading);
//"正在加载...";
ClassicsHeader.REFRESH_HEADER_RELEASE = getString(R.string.header_release);
//"释放立即刷新";
ClassicsHeader.REFRESH_HEADER_FINISH = getString(R.string.header_finish);
//"刷新完成";
ClassicsHeader.REFRESH_HEADER_FAILED = getString(R.string.header_failed);
//"刷新失败";
ClassicsHeader.REFRESH_HEADER_SECONDARY = getString(R.string.header_secondary);
//"释放进入二楼";
ClassicsHeader.REFRESH_HEADER_LASTTIME = getString(R.string.header_lasttime);
//"上次更新 M-d HH:mm";
ClassicsHeader.REFRESH_HEADER_LASTTIME = getString(R.string.header_lasttime);
//"'Last update' M-d HH:mm"
//下面示例中的值等于默认值
ClassicsHeader header = (ClassicsHeader)findViewById(R.id.header);
header.setAccentColor(android.R.color.white);
//设置强调颜色
header.setPrimaryColor(R.color.colorPrimary);
//设置主题颜色
header.setTextSizeTitle(16);
//设置标题文字大小（sp单位）
header.setTextSizeTitle(16, TypedValue.COMPLEX_UNIT_SP);
//同上（1.1.0版本删除）
header.setTextSizeTime(10);
//设置时间文字大小（sp单位）
header.setTextSizeTime(10, TypedValue.COMPLEX_UNIT_SP);
//同上（1.1.0版本删除）
header.setTextTimeMarginTop(10);
//设置时间文字的上边距（dp单位）
header.setTextTimeMarginTopPx(10);
//同上-像素单位（1.1.0版本删除）
header.setEnableLastTime(true);
//是否显示时间
header.setFinishDuration(500);
//设置刷新完成显示的停留时间（设为0可以关闭停留功能）
header.setDrawableSize(20);
//同时设置箭头和图片的大小（dp单位）
header.setDrawableArrowSize(20);
//设置箭头的大小（dp单位）
header.setDrawableProgressSize(20);
//设置图片的大小（dp单位）
header.setDrawableMarginRight(20);
//设置图片和箭头和文字的间距（dp单位）
header.setDrawableSizePx(20);
//同上-像素单位
header.setDrawableArrowSizePx(20);
//同上-像素单位（1.1.0版本删除）
header.setDrawableProgressSizePx(20);
//同上-像素单位（1.1.0版本删除）
header.setDrawableMarginRightPx(20);
//同上-像素单位（1.1.0版本删除）
header.setArrowBitmap(bitmap);
//设置箭头位图（1.1.0版本删除）
header.setArrowDrawable(drawable);
//设置箭头图片
header.setArrowResource(R.drawable.ic_arrow);
//设置箭头资源
header.setProgressBitmap(bitmap);
//设置图片位图（1.1.0版本删除）
header.setProgressDrawable(drawable);
//设置图片
header.setProgressResource(R.drawable.ic_progress);
//设置图片资源
header.setTimeFormat(new DynamicTimeFormat("上次更新 %s"));
//设置时间格式化（时间会自动更新）
header.setLastUpdateText("上次更新 3秒前");
//手动更新时间文字设置（将不会自动更新时间）
header.setSpinnerStyle(SpinnerStyle.Translate);
//设置移动样式（不支持：MatchLayout）
}
}xml代码设置
ClassicsFooterjava代码设置public class RefreshActivity extends Activity {
static {
ClassicsFooter.REFRESH_FOOTER_PULLING = "上拉加载更多";
ClassicsFooter.REFRESH_FOOTER_RELEASE = "释放立即加载";
ClassicsFooter.REFRESH_FOOTER_REFRESHING = "正在刷新...";
ClassicsFooter.REFRESH_FOOTER_LOADING = "正在加载...";
ClassicsFooter.REFRESH_FOOTER_FINISH = "加载完成";
ClassicsFooter.REFRESH_FOOTER_FAILED = "加载失败";
ClassicsFooter.REFRESH_FOOTER_NOTHING = "没有更多数据了";
}
@Override
protected void onCreate(Bundle savedInstanceState) {
ClassicsFooter.REFRESH_FOOTER_PULLING = getString(R.string.footer_pulling);
//"上拉加载更多";
ClassicsFooter.REFRESH_FOOTER_RELEASE = getString(R.string.footer_release);
//"释放立即加载";
ClassicsFooter.REFRESH_FOOTER_REFRESHING = getString(R.string.footer_refreshing);
//"正在刷新...";
ClassicsFooter.REFRESH_FOOTER_LOADING = getString(R.string.footer_loading);
//"正在加载...";
ClassicsFooter.REFRESH_FOOTER_FINISH = getString(R.string.footer_finish);
//"加载完成";
ClassicsFooter.REFRESH_FOOTER_FAILED = getString(R.string.footer_failed);
//"加载失败";
ClassicsFooter.REFRESH_FOOTER_NOTHING = getString(R.string.footer_nothing);
//"没有更多数据了";
//下面示例中的值等于默认值
ClassicsFooter footer = (ClassicsFooter)findViewById(R.id.footer);
footer.setAccentColor(android.R.color.white);
//设置强调颜色
footer.setPrimaryColor(R.color.colorPrimary);
//设置主题颜色
footer.setTextSizeTitle(16);
//设置标题文字大小（sp单位）
footer.setTextSizeTitle(16, TypedValue.COMPLEX_UNIT_SP);
//同上
footer.setFinishDuration(500);
//设置刷新完成显示的停留时间
footer.setDrawableSize(20);
//同时设置箭头和图片的大小（dp单位）
footer.setDrawableArrowSize(20);
//设置箭头的大小（dp单位）
footer.setDrawableProgressSize(20);
//设置图片的大小（dp单位）
footer.setDrawableMarginRight(20);
//设置图片和箭头和文字的间距（dp单位）
footer.setDrawableSizePx(20);
//同上-像素单位（1.1.0版本删除）
footer.setDrawableArrowSizePx(20);
//同上-像素单位（1.1.0版本删除）
footer.setDrawableProgressSizePx(20);
//同上-像素单位（1.1.0版本删除）
footer.setDrawableMarginRightPx(20);
//同上-像素单位（1.1.0版本删除）
footer.setArrowBitmap(bitmap);
//设置箭头位图（1.1.0版本删除）
footer.setArrowDrawable(drawable);
//设置箭头图片
footer.setArrowResource(R.drawable.ic_arrow);
//设置箭头资源
footer.setProgressBitmap(bitmap);
//设置图片位图（1.1.0版本删除）
footer.setProgressDrawable(drawable);
//设置图片
footer.setProgressResource(R.drawable.ic_progress);
//设置图片资源
footer.setSpinnerStyle(SpinnerStyle.Translate);
//设置移动样式（不支持：MatchLayout）
}
}
xml代码设置
属性表格 Attributes
| name | format | description |
|---|---|---|
| srlPrimaryColor | color | 主题颜色 |
| srlAccentColor | color | 强调颜色 |
| srlReboundDuration | integer | 释放后回弹动画时长（默认250毫秒） |
| srlHeaderHeight | dimension | Header的标准高度（dp） |
| srlFooterHeight | dimension | Footer的标准高度（dp） |
| srlHeaderInsetStart | dimension | Header的起始偏移量（dp）V1.0.5 |
| srlFooterInsetStart | dimension | Footer的起始偏移量（dp）V1.0.5 |
| srlDragRate | float | 显示拖动高度/真实拖动高度（默认0.5，阻尼效果） |
| srlHeaderMaxDragRate | float | Header最大拖动高度/Header标准高度（默认2，要求>=1） |
| srlFooterMaxDragRate | float | Footer最大拖动高度/Footer标准高度（默认2，要求>=1） |
| srlHeaderTriggerRate | float | Header触发刷新距离 与 HeaderHeight 的比率（默认1） |
| srlFooterTriggerRate | float | Footer触发加载距离 与 FooterHeight 的比率（默认1） |
| srlEnableRefresh | boolean | 是否开启下拉刷新功能（默认true） |
| srlEnableLoadMore | boolean | 是否开启加上拉加载功能（默认false-智能开启） |
| srlEnableAutoLoadMore | boolean | 是否监听列表惯性滚动到底部时触发加载事件（默认true） |
| srlEnableHeaderTranslationContent | boolean | 拖动Header的时候是否同时拖动内容（默认true） |
| srlEnableFooterTranslationContent | boolean | 拖动Footer的时候是否同时拖动内容（默认true） |
| srlEnablePreviewInEditMode | boolean | 是否在编辑模式时显示预览效果（默认true） |
| srlEnablePureScrollMode | boolean | 是否开启纯滚动模式（默认false-开启时只支持一个子视图） |
| srlEnableOverScrollDrag | boolean | 是否启用越界拖动（仿苹果效果）V1.0.4 |
| srlEnableOverScrollBounce | boolean | 设置是否开启越界回弹功能（默认true） |
| srlEnableNestedScrolling | boolean | 是否开启嵌套滚动NestedScrolling(默认false-智能开启) |
| srlEnableScrollContentWhenLoaded | boolean | 是否在加载完成之后滚动内容显示新数据（默认-true） |
| srlEnableScrollContentWhenRefreshed | boolean | 是否在刷新成功之后滚动内容显示新数据（默认-true） |
| srlEnableLoadMoreWhenContentNotFull | boolean | 在内容不满一页的时候，是否可以上拉加载更多（默认-false） |
| srlEnableFooterFollowWhenLoadFinished | boolean | 是否在全部加载结束之后Footer跟随内容 |
| srlEnableClipHeaderWhenFixedBehind | boolean | 是否剪裁Header当时样式为FixedBehind时V1.0.5 |
| srlEnableClipFooterWhenFixedBehind | boolean | 是否剪裁Footer当时样式为FixedBehind时V1.0.5 |
| srlDisableContentWhenRefresh | boolean | 是否在刷新的时候禁止内容的一切手势操作（默认false） |
| srlDisableContentWhenLoading | boolean | 是否在加载的时候禁止内容的一切手势操作（默认false） |
| srlFixedHeaderViewId | id | 指定固定顶部的视图Id |
| srlFixedFooterViewId | id | 指定固定底部的视图Id |
| srlHeaderTranslationViewId | id | 指定下拉Header时偏移的视图Id |
| srlFooterTranslationViewId | id | 指定上拉Footer时偏移的视图Id |
| name | format | description |
|---|---|---|
| setPrimaryColors | colors | 主题\强调颜色 |
| setPrimaryColorsId | colors | 主题\强调颜色资源Id |
| setReboundDuration | integer | 释放后回弹动画时长（默认250毫秒） |
| setHeaderHeight | dimension | Header的标准高度（px/dp 两个版本） |
| setFooterHeight | dimension | Footer的标准高度（px/dp 两个版本） |
| setHeaderInsetStart | dimension | Header起始位置偏移量（px/dp 两个版本）V1.0.5 |
| setFooterInsetStart | dimension | Footer起始位置偏移量（px/dp 两个版本）V1.0.5 |
| setDragRate | float | 显示拖动高度/真实拖动高度（默认0.5，阻尼效果） |
| setHeaderMaxDragRate | float | Header最大拖动高度/Header标准高度（默认2，要求>=1） |
| setFooterMaxDragRate | float | Footer最大拖动高度/Footer标准高度（默认2，要求>=1） |
| setHeaderTriggerRate | float | Header触发刷新距离 与 HeaderHeight 的比率（默认1） |
| setFooterTriggerRate | float | Footer触发加载距离 与 FooterHeight 的比率（默认1） |
| setEnableRefresh | boolean | 是否开启下拉刷新功能（默认true） |
| setEnableLoadMore | boolean | 是否开启加上拉加载功能（默认false-智能开启） |
| setEnableHeaderTranslationContent | boolean | 拖动Header的时候是否同时拖动内容（默认true） |
| setEnableFooterTranslationContent | boolean | 拖动Footer的时候是否同时拖动内容（默认true） |
| setEnableAutoLoadMore | boolean | 是否监听列表惯性滚动到底部时触发加载事件（默认true） |
| setEnablePureScrollMode | boolean | 是否开启纯滚动模式（默认false-开启时只支持一个子视图） |
| setEnableOverScrollDrag | boolean | 是否启用越界拖动（仿苹果效果）V1.0.4 |
| setEnableOverScrollBounce | boolean | 设置是否开启越界回弹功能（默认true） |
| setEnableNestedScrolling | boolean | 是否开启嵌套滚动NestedScrolling（默认false-智能开启） |
| setEnableScrollContentWhenLoaded | boolean | 是否在加载完成之后滚动内容显示新数据（默认-true） |
| setEnableScrollContentWhenRefreshed | boolean | 是否在刷新成功之后滚动内容显示新数据（默认-true）V1.0.5 |
| setEnableLoadMoreWhenContentNotFull | boolean | 在内容不满一页的时候，是否可以上拉加载更多（默认-false） |
| setEnableFooterFollowWhenLoadFinished | boolean | 是否在全部加载结束之后Footer跟随内容 |
| setEnableClipHeaderWhenFixedBehind | boolean | 是否剪裁Header当时样式为FixedBehind时V1.0.5 |
| setEnableClipFooterWhenFixedBehind | boolean | 是否剪裁Footer当时样式为FixedBehind时V1.0.5 |
| setDisableContentWhenRefresh | boolean | 是否在刷新的时候禁止内容的一切手势操作（默认false） |
| setDisableContentWhenLoading | boolean | 是否在加载的时候禁止内容的一切手势操作（默认false） |
| setReboundInterpolator | Interpolator | 设置回弹动画的插值器（默认减速） |
| setRefreshHeader | RefreshHeader | 设置指定的Header（默认贝塞尔雷达） |
| setRefreshFooter | RefreshFooter | 设置指定的Footer（默认球脉冲） |
| setRefreshContent | View | 设置刷新Content（用于动态替换空布局） |
| setOnRefreshListener | OnRefreshListener | 设置刷新监听器（不设置，默认3秒后关刷新） |
| setOnLoadMoreListener | OnLoadMoreListener | 设置加载监听器（不设置，默认3秒后关加载） |
| setOnRefreshLoadMoreListener | OnRefreshLoadMoreListener | 同时设置上面两个监听器 |
| setOnMultiPurposeListener | OnMultiPurposeListener | 设置多功能监听器 |
| setLoadMoreFinished | boolean | 设置全部数据加载完成，之后不会触发加载事件 |
| setScrollBoundaryDecider | boundary | 设置滚动边界判断 |
| finishRefresh | (int delayed) | 完成刷新，结束刷新动画 |
| finishLoadMore | (int delayed) | 完成加载，结束加载动画 |
| finishRefresh | (boolean success) | 完成刷新，并设置是否成功 |
| finishLoadMore | (boolean success) | 完成加载，并设置是否成功 |
| finishLoadMoreWithNoMoreData | 完成加载并标记没有更多数据(V1.0.4) | |
| closeHeaderOrFooter | 关闭 Header 或者 Footer（1.1.0） | |
| resetNoMoreData | V1.0.4（V1.1.0删除，用 setNoMoreData(false) 代替） | |
| setNoMoreData | boolean | 设置更多数据状态V1.0.5 |
| getRefreshHeader | RefreshHeader | 获取Header |
| getRefreshFooter | RefreshFooter | 获取Footer |
| getState | RefreshState | 获取当前状态 |
| isRefreshing | boolean | (V1.1.0删除，版本用 getState==Refreshing 代替) |
| isLoading | boolean | (V1.1.0删除，版本用 getState==Loading 代替) |
| autoRefresh | (int delayed) | 触发自动刷新 |
| autoLoadMore | (int delayed) | 触发自动加载 |
| name | format | description |
|---|---|---|
| srlPrimaryColor | color | 主题颜色 |
| srlAccentColor | color | 强调颜色 |
| srlDrawableArrow | drawable | 箭头图片 |
| srlDrawableProgress | drawable | 转动图片 |
| srlClassicsSpinnerStyle | enum | 变换样式：Translate(平行移动)、Scale（拉伸形变）、FixedBehind（固定在背后） |
| srlSpinnerStyle | enum | 变换样式：srlClassicsSpinnerStyle的全部、FixedFront（固定在前面或全屏） |
| srlFinishDuration | int | 动画结束时，显示完成状态停留的时间（毫秒） |
| srlEnableLastTime | boolean | 是否显示上次更新时间（默认true） |
| srlDrawableMarginRight | dimension | 图片相对右边文字的距离（默认20dp） |
| srlTextTimeMarginTop | dimension | 更新时间相对上面标题的距离（默认2dp） |
| srlTextSizeTitle | dimension | 标题文字大小（默认16sp） |
| srlTextSizeTime | dimension | 时间文字大小（默认12sp） |
| name | format | description |
|---|---|---|
| setPrimaryColor | color | 主题颜色 |
| setAccentColor | color | 强调颜色 |
| setArrowDrawable | drawable | 设置箭头图片 |
| setProgressDrawable | drawable | 设置转动图片 |
| setArrowBitmap | bitmap | 设置箭头图片(V1.1.0版本删除) |
| setProgressBitmap | bitmap | 设置转动图片(V1.1.0版本删除) |
| setArrowResource | int | 设置箭头图片 |
| setProgressResource | int | 设置转动图片 |
| setSpinnerStyle | enum | 变换样式：参考属性srlSpinnerStyle |
| setClassicsSpinnerStyle | enum | 变换样式：参考属性srlClassicsSpinnerStyle |
| setFinishDuration | int | 设置动画结束时，显示完成状态停留的时间（毫秒） |
| setEnableLastTime | boolean | 是否显示上次更新时间（默认true） |
| setTextSizeTitle | dimension | 标题文字大小（默认16sp） |
| setTextSizeTime | dimension | 时间文字大小（默认12sp） |
| setLastUpdateText | string | 手动设置更新时间，将不会自动更新时间 |
推荐阅读
- android第三方框架（五）ButterKnife
- Android中的AES加密-下
- 带有Hilt的Android上的依赖注入
- android|android studio中ndk的使用
- Android事件传递源码分析
- 人工智能|干货！人体姿态估计与运动预测
- RxJava|RxJava 在Android项目中的使用（一）
- Android7.0|Android7.0 第三方应用无法访问私有库
- 深入理解|深入理解 Android 9.0 Crash 机制（二）
- android防止连续点击的简单实现（kotlin）