Android SwipeRefreshLayout超詳細講解
1. 控件說明
SwipeRefreshLayout是google官方推薦使用的下拉刷新的控件,如果用戶想通過垂直滑動手勢刷新視圖的內(nèi)容,就可以使用它。
實例化此控件的Activity應(yīng)添加一個 OnRefreshListener,以便在完成滑動刷新手勢時收到通知。 SwipeRefreshLayout 會在每次手勢再次完成時通知監(jiān)聽器,監(jiān)聽器負責(zé)確定何時實際啟動其內(nèi)容的刷新。如果監(jiān)聽器不需要有刷新動作,通過調(diào)用 setRefreshing(false) 來取消任何刷新的視覺指示。如果用戶要禁用手勢和進度動畫,可以通過調(diào)用 setEnabled(false)實現(xiàn)。
SwipeRefreshLayout 經(jīng)常與ListView RecyclerView CardView控件一起使用,用來刷新數(shù)據(jù)顯示。
SwipeRefreshLayout 在xml文件中角色:它作為手勢刷新視圖的父布局控件,并且只支持一個直接子控件。
2. API介紹
| 方法 | 說明 |
| setRefreshing(boolean refreshing) | 設(shè)置刷新狀態(tài),true表示正在刷新,false表示取消刷新。 |
| isRefreshing() | 判斷當(dāng)前的狀態(tài)是否是正處于刷新狀態(tài)。 |
| setSize(int size) | 設(shè)置下拉刷新圖標(biāo)的大小, 只支持兩種: DEFAULT 和 LARGE |
| setColorSchemeResources(int…colorReslds) | 設(shè)置進度View的組合顏色,在手指上下滑時使用第一個顏色,在刷新中,會一個個顏色進行切換 |
| setColorSchemeResources(@ColorRes int... colorResIds) | 設(shè)置刷新圖標(biāo)的顏色, 在手指下滑刷新時使用第一個顏色,和 setColorSchemeColors 傳遞的參數(shù)不一樣,這里是傳入int colorResIds |
| setProgressBackgroundColorSchemeResource(@ColorRes int colorRes) | 設(shè)置刷新圖標(biāo)的背景顏色,默認為白色 |
| setOnRefreshListener(SwipeRefreshLayout.OnRefreshListener listener) | 設(shè)置監(jiān)聽,需要重寫onRefresh()方法,頂部下拉時會調(diào)用這個方法,在里面實現(xiàn)請求數(shù)據(jù)的邏輯,設(shè)置下拉進度條消失等等。 |
| setProgressViewOffset(boolean scale, int start, int end) | 設(shè)置動畫樣式下拉的起始點和結(jié)束點,scale設(shè)置是否需要放大或者縮小動畫, 第一個參數(shù):默認為false,設(shè)置為true,下拉過程中刷新圖標(biāo)就會從小變大 第二個參數(shù):起始位置,刷新圖標(biāo)距離頂部像素px 第三個參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px |
| setProgressViewEndTarget(boolean scale, int end) | 設(shè)置動畫樣式下拉的結(jié)束點 scale設(shè)置是否需要放大或者縮小動畫, 第二個參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px |
| setSlingshotDistance(@Px int slingshotDistance) | 設(shè)置可以將刷新指示器拉出其靜止位置的距離(以像素為單位) |
| setEnabled(boolean enabled) | false:禁用手勢下拉刷新動畫 |
這些API 都是通過代碼測試后,做的解釋說明,還是比較準(zhǔn)確的。
3. 使用方法
3.1 布局文件
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<androidx.swiperefreshlayout.widget.SwipeRefreshLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/swipeLayout">
<TextView
android:id="@+id/text_test"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="手動下拉刷新"
android:gravity="center"
android:textSize="30dp"/>
</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>
</RelativeLayout>SwipeRefreshLayout 作為父控件, 它僅僅只能有一個子控件,比如TextView ListView CardView 其他等...
3.2 界面代碼
public class MainActivity extends AppCompatActivity implements SwipeRefreshLayout.OnRefreshListener{
private SwipeRefreshLayout swipeRefreshLayout;
private TextView mTextView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
swipeRefreshLayout = findViewById(R.id.swipeLayout);
mTextView = findViewById(R.id.text_test);
//設(shè)置下拉刷新圖標(biāo)的大小 只支持兩種: DEFAULT 和 LARGE
swipeRefreshLayout.setSize(CircularProgressDrawable.LARGE);
//設(shè)置刷新圖標(biāo)的顏色,在手指下滑刷新時使用第一個顏色,在刷新中,會一個個顏色進行切換 這里是傳入 int... colors
swipeRefreshLayout.setColorSchemeColors(Color.BLACK, Color.GREEN, Color.RED, Color.YELLOW, Color.BLUE);
//設(shè)置刷新圖標(biāo)的顏色, 在手指下滑刷新時使用第一個顏色,和 setColorSchemeColors 傳遞的參數(shù)不一樣,這里是傳入int colorResIds
swipeRefreshLayout.setColorSchemeResources(R.color.red, R.color.blue, R.color.green);
//設(shè)置刷新圖標(biāo)的背景顏色
swipeRefreshLayout.setProgressBackgroundColorSchemeResource(R.color.teal_200);
//設(shè)置動畫樣式下拉的起始點和結(jié)束點,scale設(shè)置是否需要放大或者縮小動畫
// 第一個參數(shù):默認為false,設(shè)置為true,下拉過程中刷新圖標(biāo)就會從小變大
// 第二個參數(shù):起始位置,刷新圖標(biāo)距離頂部像素px
// 第三個參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
//swipeRefreshLayout.setProgressViewOffset(false, 100, 200);
//設(shè)置動畫樣式下拉的結(jié)束點 scale設(shè)置是否需要放大或者縮小動畫
// 第二個參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
//swipeRefreshLayout.setProgressViewEndTarget(false, 500);
//設(shè)置可以將刷新指示器拉出其靜止位置的距離(以像素為單位)
//swipeRefreshLayout.setSlingshotDistance(600);
//false:禁用手勢下拉刷新動畫
//swipeRefreshLayout.setEnabled(false);
//設(shè)置監(jiān)聽器,需要重寫onRefresh()方法
swipeRefreshLayout.setOnRefreshListener(this);
}
@Override
public void onRefresh() {
Log.e("test", "===是否==正在刷新中====" + swipeRefreshLayout.isRefreshing());
mTextView.setText("正在刷新中......");
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
mTextView.setText("刷新完成");
//注意事項:當(dāng)完成數(shù)據(jù)更新后一定要調(diào)用 setRefreshing(false),不然刷新圖標(biāo)會一直轉(zhuǎn)圈,不會消失
swipeRefreshLayout.setRefreshing(false);
}
}, 3000);
}代碼解讀:
當(dāng)手勢下拉刷新界面打印log如下:
28100 28100 E test : ===是否==正在刷新中====true
效果圖:

響應(yīng)刷新手勢
(1)當(dāng)用戶做出滑動手勢時,系統(tǒng)會顯示進度指示器并調(diào)用應(yīng)用的回調(diào)方法。您的回調(diào)方法負責(zé)應(yīng)用數(shù)據(jù)的實際更新。
(2)如需響應(yīng)應(yīng)用中的刷新手勢,請實現(xiàn) SwipeRefreshLayout.OnRefreshListener 接口及其 onRefresh() 方法。
(3)當(dāng)用戶做出滑動手勢時,系統(tǒng)會調(diào)用 onRefresh() 方法。
實際更新操作的代碼放在單獨的方法中,并通過onRefresh() 實現(xiàn)調(diào)用該更新方法。
當(dāng)完成數(shù)據(jù)更新后一定要調(diào)用setRefreshing(false), 調(diào)用此方法可指示SwipeRefreshLayout移除進度指示器并更新視圖內(nèi)容。
4. 注意事項
當(dāng)完成數(shù)據(jù)更新后,記得一定要調(diào)用setRefreshing(false) 方法,不然刷新圖標(biāo)會一直轉(zhuǎn)圈,不會消失。
到此這篇關(guān)于Android SwipeRefreshLayout超詳細講解的文章就介紹到這了,更多相關(guān)Android SwipeRefreshLayout內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- Android 使用SwipeRefreshLayout控件仿抖音做的視頻下拉刷新效果
- Android SwipeRefreshLayout仿抖音app靜態(tài)刷新
- android使用SwipeRefreshLayout實現(xiàn)ListView下拉刷新上拉加載
- android基于SwipeRefreshLayout實現(xiàn)類QQ的側(cè)滑刪除
- Android 中SwipeRefreshLayout與ViewPager滑動事件沖突解決方法
- android中SwipeRefresh實現(xiàn)各種上拉,下拉刷新示例
- Android使用Item Swipemenulistview實現(xiàn)仿QQ側(cè)滑刪除功能
- Android實現(xiàn)SwipeRefreshLayout首次進入自動刷新
- Android 中 Swipe、Scroll 和 Fling 的區(qū)別解析
相關(guān)文章
Android通過實現(xiàn)GridView的橫向滾動實現(xiàn)仿京東秒殺效果
這篇文章主要介紹了Android通過實現(xiàn)GridView的橫向滾動實現(xiàn)仿京東秒殺效果,實現(xiàn)代碼簡單易懂,非常不錯,具有一定的參考借鑒價值,需要的朋友可以參考下2018-07-07
Android App中使用Gallery制作幻燈片播放效果
這篇文章主要介紹了Android App中使用Gallery制作幻燈片播放效果,相冊應(yīng)用中的輪播功能也與本文中例子的原理類似,需要的朋友可以參考下2016-04-04
Android中TextView動態(tài)設(shè)置縮進距離的方法
項目需求如果在項目中第一行文字需要添加布局的情況我們應(yīng)該怎么做呢,經(jīng)過一番考慮和查找我最終選擇了縮進的方式解決這個問題,這篇文章主要給大家介紹了關(guān)于Android中TextView動態(tài)設(shè)置縮進距離的相關(guān)資料,需要的朋友可以參考下2022-04-04
將替代ListView的RecyclerView 的使用詳解(一)
這篇文章主要介紹了將替代ListView的RecyclerView 的使用詳解(一)的相關(guān)資料,非常不錯,具有參考借鑒價值,需要的朋友可以參考下2016-07-07
Android App實現(xiàn)應(yīng)用內(nèi)部自動更新的最基本方法示例
這篇文章主要介紹了實現(xiàn)Android App內(nèi)部自動更新的最基本方法示例,包括IIS服務(wù)器端的簡單布置,需要的朋友可以參考下2016-03-03

