/android-pull-to-refresh

Pull To Refresh Views for Android! v3.2.3

Primary LanguageJavaApache License 2.0Apache-2.0

Pull To Refresh Views for Android Renewal! v3.2

This project is a fork of Chris Banes' Android-PullToRefresh project. The project provides flexibility in customization in addition to adding brand new features listed below.

  • New! AAR package support

  • Google-like pull to refresh animation support (in Android 3.x or 4.x)

    NOTE: This style is now supported in Android Support Library. I recommend you to use the support library instead of this library, unless you are already using and want to change the style from old style to it.

  • Easy layout customization - no need to include the library's source code directly into your project.

  • Easily Customizable loading layouts, labels, and icons.

  • Ability to customize and add multiple indicator layouts.

  • Configurable friction and smooth scroll duration.

  • This fork project is not being deprecated. Please send issues or pull requests to me, and I will provide you with feedbacks.

  • Are you are using Pull To Refresh v2.1.x? You'd better MIGRATE to v3.2 now!

Introduction


Screenshot

This project aims to provide a reusable Pull to Refresh widget for Android. It was originally based on Johan Nilsson's library (mainly for graphics, strings and animations), but these have been replaced since.

Included Features

  • Supports both Pulling Down from the top, and Pulling Up from the bottom (or even both).
  • Animated Scrolling for all devices.
  • Over Scroll supports for devices on Android v2.3+.
  • Currently works with:
    • ListView
    • ExpandableListView
    • GridView
    • WebView
    • ScrollView
    • HorizontalScrollView
    • ViewPager
  • Integrated End of List Listener for use of detecting when the user has scrolled to the bottom.
  • Maven Central Support.
  • Indicators to show the user when a Pull-to-Refresh is available.
  • Support for ListFragment!
  • Lots of Customization options!

Repository at https://github.com/nhnopensource/android-pull-to-refresh.

Sample Application

Sample application is being provided as APK file (the source is in the repository):

Download Here!

Usage

To begin using the library, please see the Quick Start Guide.

Customization

Our Customization page contains detailed information on how to change the behaviour and look of the View.

Pull Up to Refresh

By default this library is set to Pull Down to Refresh, but if you want to allow Pull Up to Refresh then you can do so. You can even set the View to enable both Pull Up and Pull Down using the 'both' setting. See the Customization page for more information on how to set this.

Apps

Want to see which Apps are already using Android-PullToRefresh? Have a look here.

Changelog

Please see the new Changelog page to see what's recently changed.

Pull Requests

I will gladly accept pull requests for fixes and feature enhancements but please do them in the dev branch. The master branch is for the latest stable code, dev is where I try things out before releasing them as stable. Any pull requests that are against master from now on will be closed asking for you to do another pull against dev.

Acknowledgments

License

Copyright 2011, 2012 Chris Banes
Copyright 2013 Naver Business Platform Corp.

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.