SmoothRefreshLayout

一個高效的Android重新整理庫，理論上支援所有的檢視，比官方的SwipeRefreshLayout更強大且使用方便.
本開源庫的部分程式碼來自android-Ultra-Pull-To-Refresh.
非常感謝他提供的這麼棒的開源專案！

特性:

• 理論上支援所有的檢視,且可根據具體需求高效適配.
• 支援多點觸控.
• 支援巢狀滑動,完整實現了NestedScrollingChild，NestedScrollingParent 介面,玩轉CoordinatorLayout.
• 直接繼承自ViewGroup,擁有卓越的效能,支援類FameLayout的特性（Gravity、Margin).
• 支援自動重新整理、自動上拉載入、到底自動載入更多（不推薦，建議使用Adapter實現，可自定義到底判斷邏輯回撥實現預載入更多）.
• 支援越界回彈.
• 支援重新整理檢視自定樣式:STYLE_DEFAULT(預設不改變大小)、STYLE_SCALE(動態改變大小，一直會重測量並佈局，所以效能會有損失)、STYLE_PIN(不會改變檢視大小，固定在頂部或者底部)、STYLE_FOLLOW_SCALE(先縱向跟隨移動並且不改變檢視大小，大於檢視高度後動態改變檢視大小且效能會有損失)、STYLE_FOLLOW_PIN(不會改變檢視大小，先縱向跟隨移動，大於檢視高度後固定)、STYLE_FOLLOW_CENTER(不會改變檢視大小，先縱向跟隨移動，大於檢視高度後讓檢視保持在移動的距離中心點).
• 支援二級重新整理事件（TwoLevelSmoothRefreshLayout）,PS:淘寶二樓、京東活動.
• 支援橫向重新整理(HorizontalSmoothRefreshLayout).
• 支援ListView、GridView、RecyclerView載入更多的同步平滑滾動.
• 支援多狀態檢視:STATE_CONTENT(預設狀態)、STATE_ERROR(異常狀態)、STATE_EMPTY(空狀態)、STATE_CUSTOM(自定義狀態).
• 支援手勢:同步Fling(重新整理檢視仍可見的情況下,會先回滾隱藏重新整理檢視,而後向下傳遞Fling手勢).
• 支援作為可拉伸內部檢視佈局使用（類小米設定頁效果）.
• 豐富的回撥介面和除錯資訊,可利用現有API實現豐富的效果.

演示程式

更新日誌

老版本升級務必檢視

更新日誌

快照

• 測試拉伸收縮效果（1.6.2版本新增）
  
• 測試橫向拉伸收縮效果（1.6.2版本新增）
  
• 測試橫向重新整理（1.5.0版本新增）
  
• 測試QQ瀏覽器樣式
  
• 測試QQ活動樣式
  
• 測試2級重新整理
  
• 包含ListView
  
• 包含RecyclerView
  
• 包含ViewPager
  
• CoordinatorLayout
  
• 越界回彈模式
  
• 測試巢狀滑動
  

使用

Gradle

repositories {
    ...
    maven { url 'https://jitpack.io' }
}

dependencies {
    //核心基礎庫，包含絕大多數功能，擴充套件庫必須依賴本庫（從1.6.0版本開始Core庫不再自帶重新整理檢視實現，只包含核心功能）
    compile 'com.github.dkzwm.SmoothRefreshLayout:core:1.6.3.3'
    //預設Classic樣式的重新整理檢視實現庫(從1.6.0版本才有，是從老版本的Core庫中拆分出來的庫)
    compile 'com.github.dkzwm.SmoothRefreshLayout:ext-classic:1.6.3.3'
    //預設Material樣式的重新整理檢視實現庫(從1.6.0版本才有，是從老版本的Core庫中拆分出來的庫)
    compile 'com.github.dkzwm.SmoothRefreshLayout:ext-material:1.6.3.3'
    //工具類庫，帶有一些快捷配置工具（自動滾動重新整理工具，快速設定AppBarLayout工具）
    compile 'com.github.dkzwm.SmoothRefreshLayout:ext-utils:1.6.3.3'
    //擴充套件支援二級重新整理庫
    compile 'com.github.dkzwm.SmoothRefreshLayout:ext-two-level:1.6.3.3'
    //擴充套件支援橫向重新整理庫
    compile 'com.github.dkzwm.SmoothRefreshLayout:ext-horizontal:1.6.3.3'
}

在Xml中配置

<?xml version="1.0" encoding="utf-8"?>
<me.dkzwm.widget.srl.SmoothRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/refreshLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</me.dkzwm.widget.srl.SmoothRefreshLayout>

Java程式碼配置

SmoothRefreshLayout refreshLayout = (SmoothRefreshLayout)findViewById(R.id.smoothRefreshLayout);
refreshLayout.setHeaderView(new ClassicHeader(this));
refreshLayout.setOnRefreshListener(new RefreshingListenerAdapter() {
    @Override
    public void onRefreshBegin(boolean isRefresh) {
        mHandler.postDelayed(new Runnable() {
            @Override
            public void run() {
                refreshLayout.refreshComplete();
            }
        }, 4000);
    }
});

自定義重新整理檢視

介面定義

public interface IRefreshView <T extends IIndicator> {    

    byte TYPE_HEADER = 0;
    byte TYPE_FOOTER = 1;

    byte STYLE_DEFAULT = 0;
    byte STYLE_SCALE = 1;
    byte STYLE_PIN = 2;
    byte STYLE_FOLLOW_SCALE = 3;
    byte STYLE_FOLLOW_PIN = 4;
    byte STYLE_FOLLOW_CENTER = 5;

    /**
     * 返回是頭部檢視還是尾部檢視;
     */
    int getType();

    /**
     * 一般情況都是View實現本介面，所以返回this;
     */
    View getView();

    /**
     * 獲取檢視樣式，自1.4.8版本後支援6種樣式，STYLE_DEFAULT、STYLE_SCALE、STYLE_PIN、STYLE_FOLLOW_SCALE、STYLE_FOLLOW_PIN、STYLE_FOLLOW_CENTER;
     */
    int getStyle();

    /**
     * 獲取檢視的自定義高度，當檢視樣式為STYLE_SCALE和STYLE_FOLLOW_SCALE時，必須返回一個確切且大於0的值，使用橫向重新整理庫時，該屬性實際應該返回的是檢視的寬度;
     * 自1.6.1版本開始，如果想要當前檢視鋪滿布局即MATCH_PARENT，那麼支援返回ViewGroup.LayoutParams.MATCH_PARENT對應的值即`-1`;
     */
    int getCustomHeight();

    /**
     * 手指離開螢幕;
     */
    void onFingerUp(SmoothRefreshLayout layout, T indicator);

    /**
     * 重置檢視;
     */
    void onReset(SmoothRefreshLayout layout);

    /**
     * 重新配置檢視，準備重新整理;
     */
    void onRefreshPrepare(SmoothRefreshLayout layout);

    /**
     * 開始重新整理;
     */
    void onRefreshBegin(SmoothRefreshLayout layout, T indicator);

    /**
     * 重新整理完成;
     */
    void onRefreshComplete(SmoothRefreshLayout layout,boolean isSuccessful);

    /**
     * 當頭部或者尾部檢視發生位置變化;
     */
    void onRefreshPositionChanged(SmoothRefreshLayout layout, byte status, T indicator);

    /**
     * 當頭部或者尾部檢視仍然處於處理事務中，這時候移動其他重新整理檢視則會呼叫該方法;
     * 在1.4.6版本新加入;
     */
    void onPureScrollPositionChanged(SmoothRefreshLayout layout, byte status, T indicator);
}

新增自定義重新整理檢視

• 全域性靜態程式碼構造

        SmoothRefreshLayout.setDefaultCreator(new IRefreshViewCreator() {
            @Override
            public void createHeader(SmoothRefreshLayout layout) {
                ClassicHeader header = new ClassicHeader(layout.getContext());
                layout.setHeaderView(header);
            }

            @Override
            public void createFooter(SmoothRefreshLayout layout) {
                ClassicFooter footer = new ClassicFooter(layout.getContext());
                layout.setFooterView(footer);
            }
        });

• 動態程式碼新增

        ClassicHeader header = new ClassicHeader(mRefreshLayout.getContext());
        mRefreshLayout.setHeaderView(header);
        ClassicFooter footer = new ClassicFooter(mRefreshLayout.getContext());
        mRefreshLayout.setFooterView(footer);

• 請直接寫入Xml檔案,SmoothRefreshLayout會根據新增的View是否是實現了IRefreshView介面進行判斷

實現類QQ下拉阻尼效果


mRefreshLayout.setIndicatorOffsetCalculator(new IIndicator.IOffsetCalculator() {
@Override
public float calculate(@IIndicator.MovingStatus int status, int currentPos, float offset) {
if (status == IIndicator.MOVING_HEADER) {
if (offset < 0) {
//如果希望拖動縮回時類似QQ一樣沒有阻尼效果，阻尼效果只存在於下拉則可以在此返回offset
//如果希望拖動縮回時類似QQ一樣有阻尼效果，那麼請註釋掉這個判斷語句
return offset;
}
return (float) Math.pow(Math.pow(currentPos / 2, 1.28d) + offset, 1 / 1.28d) * 2 - currentPos;
} else if (status == IIndicator.MOVING_FOOTER) {
if (offset > 0) {
//如果希望拖動縮回時類似QQ一樣沒有阻尼效果，阻尼效果只存在於上拉則可以在此返回offset
//如果希望拖動縮回時類似QQ一樣有阻尼效果，那麼請註釋掉這個判斷語句
return offset;
}
return -((float) Math.pow(Math.pow(currentPos / 2, 1.28d) - offset, 1 / 1.28d) * 2 - currentPos);
} else {
if (offset > 0) {
return (float) Math.pow(offset, 1 / 1.28d) * 2;
} else if (offset < 0) {
return -(float) Math.pow(-offset, 1 / 1.28d) * 2;
} else {
return offset;
}
}
}
});


Xml屬性

SmoothRefreshLayout 自身配置

TwoLevelSmoothRefreshLayout 自身配置

SmoothRefreshLayout包裹內部其他View支援配置

SmoothRefreshLayout java屬性設定方法

SmoothRefreshLayout 回撥

SmoothRefreshLayout 其它

TwoLevelSmoothRefreshLayout java屬性設定方法

TwoLevelSmoothRefreshLayout 其它

Thanks

License

MIT License

Copyright (c) 2017 dkzwm
Copyright (c) 2015 liaohuqiu.net

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.