yat3s / chopin

A Android Refresh Layout including refresh header and load more and sticky header

Chopin

An Android Refresh layout including some powerful features.

RecyclerView

ViewPager

CoordinatorLayout

Any View & Advance setting

Gradle

implementation 'com.yat3s.android:chopin:0.6.2'

How to use

• XML

<?xml version="1.0" encoding="utf-8"?>
<com.yat3s.chopin.ChopinLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/chopin_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <!--Any view you want-->
    <AnyView
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</com.yat3s.chopin.ChopinLayout>

• Java or Kotlin

mChopinLayout.setHeaderIndicatorLocation(ChopinLayout.INDICATOR_LOCATION_BEHIND);
mChopinLayout.setRefreshHeaderIndicator(new LottieIndicator(this, "victory.json", 0.1f));
mChopinLayout.setOnRefreshListener(new ChopinLayout.OnRefreshListener() {
      @Override
      public void onRefresh() {
            mChopinLayout.postDelayed(new Runnable() {
                @Override
                public void run() {
                    mChopinLayout.refreshComplete();
                }
             }, 2000);
        }
    });

Customize & Other advance settings

• NotificationView

TextView headerNotificationView = new TextView(this);
mChopinLayout.setHeaderNotificationView(headerNotificationView);

// Also you can add foot notification view
TextView footerNotificationView = new TextView(this);
mChopinLayout.setFooterNotificationView(footerNotificationView);

• IndicatorLacation

// ChopinLayout.INDICATOR_LOCATION_OUTSIDE
// ChopinLayout.INDICATOR_LOCATION_FRONT
// ChopinLayout.INDICATOR_LOCATION_BEHIND
mChopinLayout.setHeaderIndicatorLocation(ChopinLayout.INDICATOR_LOCATION_OUTSIDE); 
mChopinLayout.setFooterIndicatorLocation(ChopinLayout.INDICATOR_LOCATION_BEHIND); 

• IndicatorScrollResistance

// 0.0f - 1.0f
mChopinLayout.setIndicatorScrollResistance(0.5f);

• OverScroll

mChopinLayout.setEnableOverScroll(true);

• ViewScrollChecker

mChopinLayout.setViewScrollChecker(viewScrollChecker);

// You can view this interface
public interface ViewScrollChecker {

    /**
     * Check content view whether can do refresh,
     * so you can do some edition to control view refresh.
     *
     * @param chopinLayout
     * @param contentView  The View nested in {@link ChopinLayout}
     * @return
     */
    boolean canDoRefresh(ChopinLayout chopinLayout, View contentView);

    /**
     * Check content view whether can do loading,
     * so you can do some edition to control view loading.
     *
     * @param chopinLayout
     * @param contentView
     * @return
     */
    boolean canDoLoading(ChopinLayout chopinLayout, View contentView);
}

• ScrollState

mChopinLayout.setOnStateChangeListener(new ChopinLayout.OnStateChangeListener() {
            @Override
            public void onStateChanged(ChopinLayout layout, int newState) {
                /*
                    public static final int STATE_DEFAULT = 0;
                
                    public static final int STATE_DRAGGING_DOWN = 1;
                
                    public static final int STATE_DRAGGING_UP = 2;
                
                    public static final int STATE_REFRESHING = 3;
                
                    public static final int STATE_LOADING = 4;
                
                    public static final int STATE_BOUNCING_DOWN = 5;
                
                    public static final int STATE_BOUNCING_UP = 6;
                
                    public static final int STATE_SHOWING_HEADER_NOTIFICATION = 7;
                
                    public static final int STATE_SHOWING_FOOTER_NOTIFICATION = 8;
                 */
            }

chopin's Issues

Chopin indicator.

Make a Chopin indicator for default indicator.

Tension effect support in fling

• The user can over scroll while the content view is fling or over drag.

Notification view support after refresh completed.

Indicator Repository

New indicator shop for support Chopin layout.

Demo beautify

Make demo awesome~

Indicator background support.

• Add set indicator background api.

Code compress and optimized.

Cancel refresh or loading while refreshing by pull up or pull down.

• The user cannot cancel a refresh action, it like a bug.

Optimizing code.

Now have too many codes not clearly need to be compressed and optimized.

Pull up or down uninterruptedly when content view has scroll to top or bottom

Now it will be interrupted while scrolling.

CaseIndicatorDemosActivity.java 的第31行报错，请问为什么？

老叶子，报这个错，请问原因。

Multitouch support.

If one finger pressed and another touch will reset intercepted Y.

how to use it ? Can you provide a tutorial ?

hi, Yat. How to use it ? Can you provide a tutorial ?

Optimize indicator

• Optimize indicator setting and configure api.

Last refresh or loading time.

Added last action time.

Refactor Item decoration.

• Add sticky header decoration.
• Add divider item decoration,

Multilevel refresh header indicator support.

• Add 2nd level refresh trigger while pulling down to refresh.

When will it be released？ I am looking forward to it

When will it be released？ I am looking forward to it

Document support in English and Chinese.

• Need some GIF support.

Auto refresh support.

It can auto trigger refresh when UI is ready.