Phoenix

Android Library to add beautiful Pull-to-Refresh widget

License	The Apache Software License, Version 2.0
Categories	Ant Build Tools
GroupId	com.yalantis
ArtifactId	phoenix
Last Version	1.2.3
Release Date	Nov 30, 2015
Type	aar
Description	Phoenix Android Library to add beautiful Pull-to-Refresh widget
Project URL	https://github.com/Yalantis/Phoenix
Source Code Management	https://github.com/Yalantis/Phoenix

Download phoenix

Filename	Size
phoenix-1.2.3.pom
phoenix-1.2.3.aar	195 KB
phoenix-1.2.3-sources.jar	8 KB
phoenix-1.2.3-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.yalantis/phoenix/ -->
<dependency>
    <groupId>com.yalantis</groupId>
    <artifactId>phoenix</artifactId>
    <version>1.2.3</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.yalantis/phoenix/
implementation 'com.yalantis:phoenix:1.2.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.yalantis/phoenix/
implementation ("com.yalantis:phoenix:1.2.3")

Apache Buildr

'com.yalantis:phoenix:aar:1.2.3'

Apache Ivy

<dependency org="com.yalantis" name="phoenix" rev="1.2.3">
  <artifact name="phoenix" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.yalantis', module='phoenix', version='1.2.3')
)

Scala SBT

libraryDependencies += "com.yalantis" % "phoenix" % "1.2.3"

Leiningen

[com.yalantis/phoenix "1.2.3"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.android.support » support-v4	jar	23.1.1

Project Modules

There are no modules declared in this project.

Phoenix Pull-to-Refresh

This project aims to provide a simple and customizable pull to refresh implementation. Made in [Yalantis] (https://yalantis.com/?utm_source=github)

Check this [project on Dribbble] (https://dribbble.com/shots/1650317-Pull-to-Refresh-Rentals)
Check this [project on Behance] (https://www.behance.net/gallery/20411445/Mobile-Animations-Interactions)

#Usage

For a working implementation, Have a look at the Sample Project - sample

1. Include the library as local library project.

   compile 'com.yalantis:phoenix:1.2.3'

2. Include the PullToRefreshView widget in your layout.

   <com.yalantis.phoenix.PullToRefreshView
       android:id="@+id/pull_to_refresh"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
   
       <ListView
           android:id="@+id/list_view"
           android:divider="@null"
           android:dividerHeight="0dp"
           android:layout_width="match_parent"
           android:layout_height="match_parent" />
   
   </com.yalantis.phoenix.PullToRefreshView>

3. 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() {
           mPullToRefreshView.postDelayed(new Runnable() {
               @Override
               public void run() {
                   mPullToRefreshView.setRefreshing(false);
               }
           }, REFRESH_DELAY);
       }
    });

#Customization

To customize drawables you can change:

• sun.png - Sun image
• sky.png - background image
• buildings.png - foreground image

Misc

If you need to change progress state:

	mPullToRefreshView.setRefreshing(boolean isRefreshing)

#Compatibility

• Android GINGERBREAD 2.3+

Changelog

Version: 1.2

• Sample updated with RecyclerView example
• Showing the refresh view just in it's bounds. (Issue with transparent / empty ListView)
• Possibility to set refresh view padding

Version: 1.0

• Initial Build

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 [email protected] 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.

Yalantis

Knowledge is power and the way to get power is by sharing knowledge. We are open source because this is a smart way to live, work and play.

Versions

Version
1.2.3 Nov 30, 2015
1.2.2 Jul 22, 2015
1.2.1 Jun 3, 2015
1.2.0 May 30, 2015
1.1.2 Apr 12, 2015
1.1.1 Apr 6, 2015
1.1.0 Mar 13, 2015