1. 程式人生 > >好用的下拉重新整理 上拉載入 框架 SmartRefreshLayout

好用的下拉重新整理 上拉載入 框架 SmartRefreshLayout

特點功能:

 簡單用例

1.在 build.gradle 中新增依賴

  • 支援多點觸控
  • 支援淘寶二樓和二級重新整理
  • 支援巢狀多層的檢視結構 Layout (LinearLayout,FrameLayout...)
  • 支援所有的 View(AbsListView、RecyclerView、WebView....View)
  • 支援自定義並且已經集成了很多炫酷的 Header 和 Footer.
  • 支援和ListView的無縫同步滾動 和 CoordinatorLayout 的巢狀滾動 .
  • 支援自動重新整理、自動上拉載入(自動檢測列表慣性滾動到底部,而不用手動上拉).
  • 支援自定義回彈動畫的插值器,實現各種炫酷的動畫效果.
  • 支援設定主題來適配任何場景的App,不會出現炫酷但很尷尬的情況.
  • 支援設多種滑動方式:平移、拉伸、背後固定、頂層固定、全屏
  • 支援所有可滾動檢視的越界回彈
//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'//版本隨意(非必須,引用可以解決無法預覽問題)

2.在XML佈局檔案中新增 SmartRefreshLayout

<?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.方法一 全域性設定

    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);
                    }
                });
        }
    }

    注意:方法一 設定的Header和Footer的優先順序是最低的,如果同時還使用了方法二、三,將會被其它方法取代

    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 可以開啟和關閉預覽功能-->
        <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/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"/>
    </com.scwang.smartrefresh.layout.SmartRefreshLayout>

    注意:方法二 XML設定的Header和Footer的優先順序是中等的,會被方法三覆蓋。而且使用本方法的時候,Android Studio 會有預覽效果,如下圖:

    不過不用擔心,只是預覽效果,執行的時候只有下拉才會出現~

    3.方法三 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));