好用的下拉重新整理 上拉載入 框架 SmartRefreshLayout
阿新 • • 發佈:2018-11-19
特點功能:
簡單用例
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));