SmartRefreshLayout基本使用

SmartRefeshLayout 虽然github上源码已经写的很清楚了，但是时间一长容易忘记了，还是将github上面的内容搬下来吧，方便后续自己在工程中使用，更多的使用还是去github上下载源码看会比较有提高

SmartRefreshLayout的目标是打造一个强大，稳定，成熟的下拉刷新框架，并集成各种的炫酷、多样、实用、美观的Header和Footer。 正如名字所说，SmartRefreshLayout是一个“聪明”或者“智能”的下拉刷新布局，由于它的“智能”，它不只是支持所有的View，还支持多层嵌套的视图结构。 它继承自ViewGroup 而不是FrameLayout或LinearLayout，提高了性能。 也吸取了现在流行的各种刷新布局的优点，包括谷歌官方的 SwipeRefreshLayout， 其他第三方的 Ultra-Pull-To-Refresh、TwinklingRefreshLayout 。 还集成了各种炫酷的 Header 和 Footer。

github 源码地址https://github.com/scwang90/SmartRefreshLayout

特点功能:

• 支持多点触摸
• 支持淘宝二楼和二级刷新
• 支持嵌套多层的视图结构 Layout (LinearLayout,FrameLayout…)
• 支持所有的 View（AbsListView、RecyclerView、WebView…View）
• 支持自定义并且已经集成了很多炫酷的 Header 和 Footer.
• 支持和 ListView 的无缝同步滚动 和 CoordinatorLayout 的嵌套滚动 .
• 支持自动刷新、自动上拉加载（自动检测列表惯性滚动到底部，而不用手动上拉）.
• 支持自定义回弹动画的插值器，实现各种炫酷的动画效果.
• 支持设置主题来适配任何场景的 App，不会出现炫酷但很尴尬的情况.
• 支持设多种滑动方式：平移、拉伸、背后固定、顶层固定、全屏
• 支持所有可滚动视图的越界回弹
• 支持 Header 和 Footer 交换混用
• 支持AndroidX

在 build.gradle 中添加依赖

//1.1.0 （1.0.5及以前版本的老用户升级需谨慎，API改动过大）
compile 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-alpha-24'
compile 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-alpha-24'//没有使用特殊Header，可以不加这行
compile 'com.android.support:appcompat-v7:25.3.1'//版本 23以上（必须）

//1.1.0 androidx 版本
implementation 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-andx-7'
implementation 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-andx-7'
implementation 'androidx.legacy:legacy-support-v4:1.0.0'

主要属性设置

   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.4

    refreshLayout.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.4

    refreshLayout.setEnableScrollContentWhenRefreshed(true);//是否在刷新完成时滚动列表显示新的内容 1.0.5
    refreshLayout.srlEnableClipHeaderWhenFixedBehind(true);//是否剪裁Header当时样式为FixedBehind时1.0.5
    refreshLayout.srlEnableClipFooterWhenFixedBehind(true);//是否剪裁Footer当时样式为FixedBehind时1.0.5

    refreshLayout.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.4

    refreshLayout.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

---

作者：lz强
来源：CSDN
原文：https://blog.csdn.net/liu362732346/article/details/83056726
版权声明：本文为博主原创文章，转载请附上博文链接！

另外附上https://www.jianshu.com/p/09a763213817的文章，里面已经讲了基本的使用，感谢大牛的贡献