一、前言:
這一篇文章是解析Android智能下拉刷新框架-SmartRefreshLayout 植锉,這是一篇上拉加載和下拉刷新泥栖,非常優(yōu)秀的文章,里面豐富的動畫弧满,基本上能滿足你的需求婆跑。
它的項(xiàng)目地址:
1. 支持類型
- 支持所有的 View(AbsListView、RecyclerView庭呜、WebView....View) 和多層嵌套的視圖結(jié)構(gòu)
- 支持自定義并且已經(jīng)集成了很多炫酷的 Header 和 Footer (圖).
- 支持和ListView的同步滾動 和 RecyclerView滑进、AppBarLayout、CoordinatorLayout 的嵌套滾動 NestedScrolling.
- 支持在Android Studio Xml 編輯器中預(yù)覽 效果(圖)
- 支持分別在 Default(默認(rèn))募谎、Xml扶关、JavaCode 三個(gè)中設(shè)置 Header 和 Footer.
- 支持自動刷新、自動上拉加載(自動檢測列表慣性滾動到底部数冬,而不用手動上拉).
- 支持通用的刷新監(jiān)聽器 OnRefreshListener 和更詳細(xì)的滾動監(jiān)聽 OnMultiPurposeListener.
- 支持自定義回彈動畫的插值器节槐,實(shí)現(xiàn)各種炫酷的動畫效果.
- 支持設(shè)置主題來適配任何場景的App,不會出現(xiàn)炫酷但很尷尬的情況.
- 支持設(shè)置多種滑動方式來適配各種效果的Header和Footer:平移拐纱、拉伸铜异、背后固定、頂層固定戳玫、全屏
- 支持內(nèi)容尺寸自適應(yīng) Content-wrap_content
- 支持繼承重寫和擴(kuò)展功能熙掺,內(nèi)部實(shí)現(xiàn)沒有 private 方法和字段,繼承之后都可以重寫覆蓋
- 支持越界回彈(Listview咕宿、RecyclerView币绩、ScrollView、WebView...View)
- 支持多點(diǎn)觸摸府阀,下拉缆镣、上拉各種手勢沖突
2. 部分展示效果圖
gif_practive_weibo.gif
11111.gif
2222.gif
二、基本使用:
1. 依賴:
//普通用戶依賴這個(gè)V1.1.0
compile 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-alpha-31'
//沒有使用特殊Header试浙,可以不加這行
compile 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-alpha-31'
//recyclerview依賴
implementation 'com.android.support:recyclerview-v7:27.1.1'
//V1.1.0 androidx 版本董瞻,Android 水滴屏依賴這個(gè)
//implementation 'com.scwang.smartrefresh:SmartRefreshLayout:1.1.0-andx-14'
//implementation 'com.scwang.smartrefresh:SmartRefreshHeader:1.1.0-andx-14'
2. 在XML布局文件中添加 SmartRefreshLayout(默認(rèn)):
<?xml version="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.support.v7.widget.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:overScrollMode="never"
android:background="#fff" />
</com.scwang.smartrefresh.layout.SmartRefreshLayout>
3. 在 Activity 或者 Fragment 中添加代碼:
RefreshLayout refreshLayout = (RefreshLayout)findViewById(R.id.refreshLayout);
refreshLayout.setOnRefreshListener(new OnRefreshListener() {
@Override
public void onRefresh(RefreshLayout refreshlayout) {
refreshlayout.finishRefresh(2000/*,false*/);//傳入false表示刷新失敗
}
});
refreshLayout.setOnLoadMoreListener(new OnLoadMoreListener() {
@Override
public void onLoadMore(RefreshLayout refreshlayout) {
refreshlayout.finishLoadMore(2000/*,false*/);//傳入false表示加載失敗
}
});
三、使用指定的 Header 和 Footer
1. 方法一 全局設(shè)置
public class App extends Application {
//static 代碼段可以防止內(nèi)存泄露
static {
//設(shè)置全局的Header構(gòu)建器
SmartRefreshLayout.setDefaultRefreshHeaderCreator(new DefaultRefreshHeaderCreator() {
@Override
public RefreshHeader createRefreshHeader(Context context, RefreshLayout layout) {
layout.setPrimaryColorsId(R.color.colorPrimary, android.R.color.white);//全局設(shè)置主題顏色
return new ClassicsHeader(context);//.setTimeFormat(new DynamicTimeFormat("更新于 %s"));//指定為經(jīng)典Header田巴,默認(rèn)是 貝塞爾雷達(dá)Header
}
});
//設(shè)置全局的Footer構(gòu)建器
SmartRefreshLayout.setDefaultRefreshFooterCreator(new DefaultRefreshFooterCreator() {
@Override
public RefreshFooter createRefreshFooter(Context context, RefreshLayout layout) {
//指定為經(jīng)典Footer钠糊,默認(rèn)是 BallPulseFooter
return new ClassicsFooter(context).setDrawableSize(20);
}
});
}
}
注意:方法一 設(shè)置的Header和Footer的優(yōu)先級是最低的,如果同時(shí)還使用了方法二壹哺、三抄伍,將會被其它方法取代
2. XML布局文件指定
<com.scwang.smartrefresh.layout.SmartRefreshLayout
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/refreshLayout"
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 可以開啟和關(guān)閉預(yù)覽功能-->
<com.scwang.smartrefresh.layout.header.ClassicsHeader
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="@dimen/dimenPaddingCommon"
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"/>
</com.scwang.smartrefresh.layout.SmartRefreshLayout>
3. XML布局文件指定
注意:方法二 XML設(shè)置的Header和Footer的優(yōu)先級是中等的,會被方法三覆蓋管宵。而且使用本方法的時(shí)候截珍,Android Studio 會有預(yù)覽效果攀甚,如下圖:
圖片.png
不過不用擔(dān)心,只是預(yù)覽效果岗喉,運(yùn)行的時(shí)候只有下拉才會出現(xiàn)~
4. Java代碼設(shè)置
final RefreshLayout refreshLayout = (RefreshLayout) findViewById(R.id.refreshLayout);
//設(shè)置 Header 為 貝塞爾雷達(dá) 樣式
refreshLayout.setRefreshHeader(new BezierRadarHeader(this).setEnableHorizontalDrag(true));
//設(shè)置 Footer 為 球脈沖 樣式
refreshLayout.setRefreshFooter(new BallPulseFooter(this).setSpinnerStyle(SpinnerStyle.Scale));