欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

Android SwipeRefreshLayout超詳細(xì)講解

 更新時(shí)間:2022年11月03日 11:56:26   作者:broadview_java  
在android開(kāi)發(fā)中,使用最多的數(shù)據(jù)刷新方式就是下拉刷新了,而完成此功能我們使用最多的就是第三方的開(kāi)源庫(kù)PullToRefresh。現(xiàn)如今,google也忍不住推出了自己的下拉組件SwipeRefreshLayout,下面我們通過(guò)api文檔和源碼來(lái)分析學(xué)習(xí)如何使用SwipeRefreshLayout

1. 控件說(shuō)明

SwipeRefreshLayout是google官方推薦使用的下拉刷新的控件,如果用戶想通過(guò)垂直滑動(dòng)手勢(shì)刷新視圖的內(nèi)容,就可以使用它。

實(shí)例化此控件的Activity應(yīng)添加一個(gè) OnRefreshListener,以便在完成滑動(dòng)刷新手勢(shì)時(shí)收到通知。 SwipeRefreshLayout 會(huì)在每次手勢(shì)再次完成時(shí)通知監(jiān)聽(tīng)器,監(jiān)聽(tīng)器負(fù)責(zé)確定何時(shí)實(shí)際啟動(dòng)其內(nèi)容的刷新。如果監(jiān)聽(tīng)器不需要有刷新動(dòng)作,通過(guò)調(diào)用 setRefreshing(false) 來(lái)取消任何刷新的視覺(jué)指示。如果用戶要禁用手勢(shì)和進(jìn)度動(dòng)畫(huà),可以通過(guò)調(diào)用 setEnabled(false)實(shí)現(xiàn)。

SwipeRefreshLayout 經(jīng)常與ListView RecyclerView CardView控件一起使用,用來(lái)刷新數(shù)據(jù)顯示。

SwipeRefreshLayout 在xml文件中角色:它作為手勢(shì)刷新視圖的父布局控件,并且只支持一個(gè)直接子控件。

2. API介紹

方法說(shuō)明
setRefreshing(boolean refreshing)設(shè)置刷新?tīng)顟B(tài),true表示正在刷新,false表示取消刷新。
isRefreshing()判斷當(dāng)前的狀態(tài)是否是正處于刷新?tīng)顟B(tài)。
setSize(int size)設(shè)置下拉刷新圖標(biāo)的大小, 只支持兩種: DEFAULT  和 LARGE
setColorSchemeResources(int…colorReslds)設(shè)置進(jìn)度View的組合顏色,在手指上下滑時(shí)使用第一個(gè)顏色,在刷新中,會(huì)一個(gè)個(gè)顏色進(jìn)行切換
setColorSchemeResources(@ColorRes int... colorResIds)設(shè)置刷新圖標(biāo)的顏色, 在手指下滑刷新時(shí)使用第一個(gè)顏色,和 setColorSchemeColors 傳遞的參數(shù)不一樣,這里是傳入int colorResIds
setProgressBackgroundColorSchemeResource(@ColorRes int colorRes)設(shè)置刷新圖標(biāo)的背景顏色,默認(rèn)為白色
setOnRefreshListener(SwipeRefreshLayout.OnRefreshListener listener)設(shè)置監(jiān)聽(tīng),需要重寫(xiě)onRefresh()方法,頂部下拉時(shí)會(huì)調(diào)用這個(gè)方法,在里面實(shí)現(xiàn)請(qǐng)求數(shù)據(jù)的邏輯,設(shè)置下拉進(jìn)度條消失等等。
setProgressViewOffset(boolean scale, int start, int end)設(shè)置動(dòng)畫(huà)樣式下拉的起始點(diǎn)和結(jié)束點(diǎn),scale設(shè)置是否需要放大或者縮小動(dòng)畫(huà), 第一個(gè)參數(shù):默認(rèn)為false,設(shè)置為true,下拉過(guò)程中刷新圖標(biāo)就會(huì)從小變大

第二個(gè)參數(shù):起始位置,刷新圖標(biāo)距離頂部像素px

第三個(gè)參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
setProgressViewEndTarget(boolean scale, int end)設(shè)置動(dòng)畫(huà)樣式下拉的結(jié)束點(diǎn) scale設(shè)置是否需要放大或者縮小動(dòng)畫(huà), 第二個(gè)參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
setSlingshotDistance(@Px int slingshotDistance)設(shè)置可以將刷新指示器拉出其靜止位置的距離(以像素為單位)
setEnabled(boolean enabled)false:禁用手勢(shì)下拉刷新動(dòng)畫(huà)

這些API 都是通過(guò)代碼測(cè)試后,做的解釋說(shuō)明,還是比較準(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="手動(dòng)下拉刷新"
            android:gravity="center"
            android:textSize="30dp"/>
    </androidx.swiperefreshlayout.widget.SwipeRefreshLayout>
</RelativeLayout>

SwipeRefreshLayout 作為父控件, 它僅僅只能有一個(gè)子控件,比如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)的顏色,在手指下滑刷新時(shí)使用第一個(gè)顏色,在刷新中,會(huì)一個(gè)個(gè)顏色進(jìn)行切換 這里是傳入 int... colors
        swipeRefreshLayout.setColorSchemeColors(Color.BLACK, Color.GREEN, Color.RED, Color.YELLOW, Color.BLUE);
        //設(shè)置刷新圖標(biāo)的顏色, 在手指下滑刷新時(shí)使用第一個(gè)顏色,和 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è)置動(dòng)畫(huà)樣式下拉的起始點(diǎn)和結(jié)束點(diǎn),scale設(shè)置是否需要放大或者縮小動(dòng)畫(huà)
        // 第一個(gè)參數(shù):默認(rèn)為false,設(shè)置為true,下拉過(guò)程中刷新圖標(biāo)就會(huì)從小變大
        // 第二個(gè)參數(shù):起始位置,刷新圖標(biāo)距離頂部像素px
        // 第三個(gè)參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
        //swipeRefreshLayout.setProgressViewOffset(false, 100, 200);
        //設(shè)置動(dòng)畫(huà)樣式下拉的結(jié)束點(diǎn)  scale設(shè)置是否需要放大或者縮小動(dòng)畫(huà)
        // 第二個(gè)參數(shù):結(jié)束位置,刷新圖標(biāo)距離頂部像素px
        //swipeRefreshLayout.setProgressViewEndTarget(false, 500);
        //設(shè)置可以將刷新指示器拉出其靜止位置的距離(以像素為單位)
        //swipeRefreshLayout.setSlingshotDistance(600);
        //false:禁用手勢(shì)下拉刷新動(dòng)畫(huà)
        //swipeRefreshLayout.setEnabled(false);
        //設(shè)置監(jiān)聽(tīng)器,需要重寫(xiě)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("刷新完成");
                //注意事項(xiàng):當(dāng)完成數(shù)據(jù)更新后一定要調(diào)用 setRefreshing(false),不然刷新圖標(biāo)會(huì)一直轉(zhuǎn)圈,不會(huì)消失
                swipeRefreshLayout.setRefreshing(false);
            }
        }, 3000);
    }

代碼解讀:

當(dāng)手勢(shì)下拉刷新界面打印log如下:

28100 28100 E test    : ===是否==正在刷新中====true

效果圖:

響應(yīng)刷新手勢(shì)

(1)當(dāng)用戶做出滑動(dòng)手勢(shì)時(shí),系統(tǒng)會(huì)顯示進(jìn)度指示器并調(diào)用應(yīng)用的回調(diào)方法。您的回調(diào)方法負(fù)責(zé)應(yīng)用數(shù)據(jù)的實(shí)際更新。

(2)如需響應(yīng)應(yīng)用中的刷新手勢(shì),請(qǐng)實(shí)現(xiàn) SwipeRefreshLayout.OnRefreshListener 接口及其 onRefresh() 方法。

(3)當(dāng)用戶做出滑動(dòng)手勢(shì)時(shí),系統(tǒng)會(huì)調(diào)用 onRefresh() 方法。

實(shí)際更新操作的代碼放在單獨(dú)的方法中,并通過(guò)onRefresh() 實(shí)現(xiàn)調(diào)用該更新方法。

當(dāng)完成數(shù)據(jù)更新后一定要調(diào)用setRefreshing(false), 調(diào)用此方法可指示SwipeRefreshLayout移除進(jìn)度指示器并更新視圖內(nèi)容。

4. 注意事項(xiàng)

當(dāng)完成數(shù)據(jù)更新后,記得一定要調(diào)用setRefreshing(false) 方法,不然刷新圖標(biāo)會(huì)一直轉(zhuǎn)圈,不會(huì)消失。

到此這篇關(guān)于Android SwipeRefreshLayout超詳細(xì)講解的文章就介紹到這了,更多相關(guān)Android SwipeRefreshLayout內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!

相關(guān)文章

最新評(píng)論