Share from here 我是个快乐的搬运工
Android智能下拉刷新框架,支持越界回弹,集成了几十种炫酷的Header和 Footer。 RefreshLayout,OverScroll.
特点功能:
支持自定义并且已经集成了很多炫酷的 Header 和 Footer 支持和ListView的同步滚动 和 RecyclerView、AppBarLayout、CoordinatorLayout 的嵌套滚动 NestedScrolling.
支持在Android Studio Xml 编辑器中预览 效果 支持分别在 Default(默认)、Xml、JavaCode 三个中设置 Header 和 Footer.
支持自动刷新、自动上拉加载(自动检测列表滚动到底部,而不用手动上拉). 支持通用的刷新监听器 OnRefreshListener 和更详细的滚动监听 OnMultiPurposeListener.
支持自定义回弹动画的插值器,实现各种炫酷的动画效果. 支持设置主题来适配任何场景的App,不会出现炫酷但很尴尬的情况.
支持设置多种滑动方式来适配各种效果的Header和Footer:平移、拉伸、背后固定、顶层固定、全屏 支持内容尺寸自适应 Content-wrap_content
支持继承重写和扩展功能,内部实现没有 private 方法和字段,继承之后都可以重写覆盖 支持越界回弹(Listview、RecyclerView、ScrollView、WebView…View)
简单用例
1.在 buld.gradle 中添加依赖
简单用例
```
//1.1.0 API改动过大,老用户升级需谨慎
compile 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-alpha-6'
compile 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-alpha-6'//没有使用特殊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'//版本随意(非必须,引用可以解决无法预览问题
```
2.在XML布局文件中添加 SmartRefreshLayout
<?xmlversion="1.0"encoding="utf-8"?>
<com.scwang.smartrefresh.layout.SmartRefreshLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/refreshLayout"
android:layout_width="match_parent"
android:layout_height="match_parent">
android:id="@+id/recyclerview"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:overScrollMode="never"
android:background="#fff"/>
3.在 Activity 或者 Fragment 中添加代码
RefreshLayout refreshLayout=(RefreshLayout)findViewById(R.id.refreshLayout);refreshLayout.setOnRefreshListener(new OnRefreshListener() {@Overridepublic void onRefresh(RefreshLayoutrefreshlayout) { refreshlayout.finishRefresh(2000); }});refreshLayout.setOnLoadmoreListener(new OnLoadmoreListener() {@Overridepublic void onLoadmore(RefreshLayoutrefreshlayout) { refreshlayout.finishLoadmore(2000); }});
使用指定的 Header 和 Footer
1.方法一 全局设置
SmartRefreshLayout.setDefaultRefreshHeaderCreater(new DefaultRefreshHeaderCreater({ @Override public RefreshHeader createRefreshHeader(Contextcontext,RefreshLayoutlayout) { return new ClassicsHeader(context);//指定为经典Header,默认是 贝塞尔雷达Header } });//设置全局的Footer构建器SmartRefreshLayout.setDefaultRefreshFooterCreater(new DefaultRefreshFooterCreater() { @Override public RefreshFooter createRefreshFooter(Contextcontext,RefreshLayoutlayout) { return new ClassicsFooter(context);//指定为经典Footer,默认是 BallPulseFooter } });
注意:方法一 设置的Header和Footer的优先级是最低的,如果同时还使用了方法二、三,将会被其他方法取代
2.方法二 XML布局文件指定
<com.scwang.smartrefresh.layout.SmartRefreshLayoutxmlns:app="http://schemas.android.com/apk/resauto" android:id="@+id/smartLayout" android:layout_width="match_parent" android:layout_height="match_parent" android:background="#444444" app:srlPrimaryColor="#444444" app:srlAccentColor="@android:color/white" app:srlEnablePreviewInEditMode="true"> < !--srlAccentColor srlPrimaryColor 将会改变 Header 和 Footer 的主题颜色--> < !--srlEnablePreviewInEditMode 可以开启和关闭预览功能--><com.scwang.smartrefresh.layout.header.ClassicsHeader android:layout_width="match_parent" android:layout_height="wrap_content" app:srlClassicsSpinnerStyle="FixedBehind"/><!--FixedBehind可以让Header固定在内容的背后,下拉的时候效果同微信浏览器的效果--><TextView android:layout_width="match_parent" android:layout_height="match_parent" android:padding="@dimen/padding_common" android:background="@android:color/white" android:text="@string/description_define_in_xml"/><com.scwang.smartrefresh.layout.footer.ClassicsFooter android:layout_width="match_parent" android:layout_height="wrap_content" app:srlClassicsSpinnerStyle="FixedBehind"/><!--FixedBehind可以让Footer固定在内容的背后,下拉的时候效果同微信浏览器的效果-->/com.scwang.smartrefresh.layout.SmartRefreshLayout>
注意:方法二 XML设置的Header和Footer的优先级是中等的,会被方法三覆盖。
3.方法三 Java代码设置
final RefreshLayout refreshLayout=(RefreshLayout) findViewById(R.id.smartLayout);//设置 Header 为 Material风格refreshLayout.setRefreshHeader(new MaterialHeader(this).setShowBezierWave(true));//设置 Footer 为 球脉冲refreshLayout.setRefreshFooter(new BallPulseFooter(this).setSpinnerStyle(SpinnerStyle.Scale));