An efficient, stable and powerful Android refresh library

English| Chinese

Features:

• All views are theoretically supported and can be adapted efficiently according to specific requirements.
• Support nesting sliding, complete implementation of NestedScrollingChild, NestedScrollingParent interface, play CoordinatorLayout.
• Inherit directly from ViewGroup, have excellent performance, support FameLayout like features (Gravity, Margin).
• Supports automatic refresh, automatic pull-up loading, and more automatic loading (not recommended. Adapter is recommended. You can customize the logic callback to realize more preloading).
• Support rebound across the border.
• Support for drawer effects (that is, the refresh view is anchored below the content view).
• Support refreshing view customization styles,STYLE_DEFAULT(default does not change size), STYLE_SCALE(dynamic change size)
• Support level 2 refresh event (TwoLevelSmoothRefreshLayout), PS: taobao, jingdong activities on the second floor.
• Support ListView, GridView, RecyclerView to load more smooth scrolling.
• Margin support for content view,PS: No Margin effect in scrolling? SmoothRefreshLayout doesn’t have this problem.
• Supports multi-state views,STATE_CONTENT(default state), STATE_ERROR(exception state),STATE_EMPTY(empty state), and STATE_CUSTOM(custom state).
• Rich callback interface and debugging information, leveraging existing apis to achieve rich effects.

The demo

Update log

Be sure to check the upgrade of earlier versions

The snapshot

• Test QQ browser style
  
  

• Test QQ activity style
  
  

• Test level 2 flush
  
  

• Contains the FrameLayout
  
  

• Contains the TextView
  
  

• Contains a ListView
  
  

• Contains the GridView
  
  

• Contains RecyclerView
  
  

• Contains the ViewPager
  
  

• Contains the WebView
  
  

• CoordinatorLayout
  
  

• Jump back mode
  
  

• Test nested sliding
  
  

use

Gradle

repositories { ... Dependencies maven {url 'https://jitpack.io'}} {the compile 'com. Making. DKZWM: SmoothRefreshLayout: 1.4.5'}Copy the code

Configure in Xml

Since v1.4.1

<? The 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/smoothRefreshLayout" 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>Copy the code

Earlier than v1.4.1

<? The XML version = "1.0" encoding = "utf-8"? > <me.dkzwm.smoothrefreshlayout.SmoothRefreshLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:id="@+id/smoothRefreshLayout" android:layout_width="match_parent" android:layout_height="match_parent"> <TextView android:layout_width="match_parent" android:layout_height="match_parent"/> </me.dkzwm.smoothrefreshlayout.SmoothRefreshLayout>Copy the code

Java Code Configuration

SmoothRefreshLayout refreshLayout = (SmoothRefreshLayout)findViewById(R.id.smoothRefreshLayout); refreshLayout.setMode(SmoothRefreshLayout.MODE_BOTH); 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); }});Copy the code

Customize the refresh view

The interface definition

public interface IRefreshView { byte TYPE_HEADER = 0; byte TYPE_FOOTER = 1; byte STYLE_DEFAULT = 0; byte STYLE_SCALE = 1; /** * returns a header view or a tail view */ int getType(); /** * Return this; */ View getView(); /** * Get view style, now support 2 styles, default style and scale style. */ int getStyle(); /** * Get the custom height of the view. If the view style is STYLE_SCALE, an exact value greater than 0 must be returned. /** * Remove finger from screen */ void onFingerUp(SmoothRefreshLayout, IIndicator); /** * reset the view */ void onReset(SmoothRefreshLayout); /** * reconfigure the view, ready to refresh */ void onRefreshPrepare(SmoothRefreshLayout); /** * start refresh */ void onRefreshBegin(SmoothRefreshLayout, IIndicator); /** * refresh complete */ void onRefreshComplete(SmoothRefreshLayout layout, Boolean isSuccessful); /** * Void onRefreshPositionChanged(SmoothRefreshLayout, byte Status, IIndicator); }Copy the code

Add a custom refresh view

• Global static code construction

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

Copy the code

• Dynamic code addition

    setHeaderView(@NonNull IRefreshView header);
    setFooterView(@NonNull IRefreshView footer);

Copy the code

• SmoothRefreshLayout will determine if the added View implements the IRefreshView interface

Xml attributes

SmoothRefreshLayout configures itself

TwoLevelSmoothRefreshLayout itself configuration

Versions later than V1.4.5

Version prior to V1.4.5

SmoothRefreshLayout supports configuration of other views inside the package

SmoothRefreshLayout Java property setting method

SmoothRefreshLayout callback

SmoothRefreshLayout other

TwoLevelSmoothRefreshLayout Java attribute set method

TwoLevelSmoothRefreshLayout other

Thanks

• liaohuqiu android-Ultra-Pull-To-Refresh
• pnikosis material-progress

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.
Copy the code