/pull-to-make-soup

Custom animated pull-to-refresh that can be easily added to RecyclerView

Primary LanguageJava

PullToMakeSoup

Custom animated pull-to-refresh that can be easily added to RecyclerView

Yalantis

Android Gems

Android Arsenal

Inspired by this project on dribble

Requirements

Min SDK version 16

Installing with Gradle

In your project level build.gradle

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

In your app level build.gradle

 compile 'com.github.Yalantis:pull-to-make-soup:1.0.2'

Usage

Include the library as local library project.

Second include PullToRefreshView to your layout, with the app:type="soup"

<com.yalantis.pulltomakesoup.PullToRefreshView
    android:id="@+id/pull_to_refresh"
    app:type="soup"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:divider="@null"
        android:dividerHeight="0dp"
        android:fadingEdge="none"/>

</com.yalantis.pulltomakesoup.PullToRefreshView>

Next in your onCreate method refer to the View and setup OnRefreshListener.

mPullToRefreshView = (PullToRefreshView) findViewById(R.id.pull_to_refresh);
mPullToRefreshView.setOnRefreshListener(new PullToRefreshView.OnRefreshListener() {
    @Override
    public void onRefresh() {}
});

When you need to finish the refreshing call

mPullToRefreshView.setRefreshing(false);

Misc

If you need to change progress state:

	mPullToRefreshView.setRefreshing(boolean isRefreshing)

Compatibility

  • Android JELLY BEAN 4.1+

Version: 1.0

  • Initial Build

Version: 1.0.1

  • Fixed disapearing animation (Flames,cover and water now disapearing properly).

Let us know!

We’d be really happy if you sent us links to your projects where you use our component. Just send an email to github@yalantis.com And do let us know if you have any questions or suggestion regarding the animation.

P.S. We’re going to publish more awesomeness wrapped in code and a tutorial on how to make UI for Android (iOS) better than better. Stay tuned!

License

Copyright 2017, Yalantis

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.