This project aims to provide a reusable Pull to Refresh widget for Android. It is originally (loosely) based on Johan Nilsson's Library (mainly for graphics, strings and animations), and has been vastly improved since then.

• Supports both Pulling Down from the top, and Pulling Up from the bottom
• Animated Scrolling for all devices (Tested on 1.6+)
• Works for all AbsListView. I've implemented both ListView and GridView.
• Works with ExpandableListView (thanks to Stefano Dacchille)
• Integrated End of List Listener ( setOnLastItemVisibleListener() )
• Maven Support (thanks to Stefano Dacchille)
• No longer shows the Tap to Refresh view when the AdapterView can not fill itself.

Repository at https://github.com/chrisbanes/Android-PullToRefresh.

<!--
  The PullToRefreshListView replaces a standard ListView widget.
  The ID CAN NOT be @+id/android:list
-->
<com.handmark.pulltorefresh.library.PullToRefreshListView
    android:id="@+id/pull_to_refresh_listview"
    android:layout_height="fill_parent"
    android:layout_width="fill_parent" />

It can also be styled using XML, such as in the sample ExpandableListView Sample:

<com.handmark.pulltorefresh.library.PullToRefreshExpandableListView
    xmlns:ptr="http://schemas.android.com/apk/res-auto"
    android:id="@+id/pull_refresh_expandable_list"
    android:layout_height="fill_parent"
    android:layout_width="fill_parent"
    ptr:ptrAdapterViewBackground="@android:color/white"
    ptr:ptrHeaderBackground="@android:color/darker_gray"
    ptr:ptrHeaderTextColor="@android:color/white" />

// Set a listener to be invoked when the list should be refreshed.
PullToRefreshListView pullToRefreshView = (PullToRefreshListView) findViewById(R.id.pull_to_refresh_listview);
pullToRefreshView.setOnRefreshListener(new OnRefreshListener() {
    @Override
    public void onRefresh() {
        // Do work to refresh the list here.
        new GetDataTask().execute();
    }
});

private class GetDataTask extends AsyncTask<Void, Void, String[]> {
    ...
    @Override
    protected void onPostExecute(String[] result) {
        // Call onRefreshComplete when the list has been refreshed.
        pullToRefreshView.onRefreshComplete();
        super.onPostExecute(result);
    }
}

By default this library is set to Pull Down to Refresh, but if you instead to Pull Up to Refresh you can do so via XML:

<com.handmark.pulltorefresh.library.PullToRefreshListView
    xmlns:ptr="http://schemas.android.com/apk/res-auto"
    android:id="@+id/pull_refresh_list"
    android:layout_height="fill_parent"
    android:layout_width="fill_parent"
    ptr:ptrMode="pullUpFromBottom" />

You can even set the View to enable both Pulling Up and Pulling Down using the new 'both' setting. For example:

<com.handmark.pulltorefresh.library.PullToRefreshListView
    xmlns:ptr="http://schemas.android.com/apk/res-auto"
    android:id="@+id/pull_refresh_list"
    android:layout_height="fill_parent"
    android:layout_width="fill_parent"
    ptr:ptrMode="both" />

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.

• New (better) way of handling Touch Events
• Add new way for PullToRefreshListView to work. Allows the user to scroll while it's refreshing.
• Fix Pull from Bottom happening when the view wasn't completely at the bottom
• Allow outside code to update the Widget to be refreshing (see setRefreshing())
• Fix Padding being doubled when added via XML
• New Translations

• Fix bug where disabling scrolling has no effect when manual refreshing (thanks Maxim Galkin)

• String Updates (thanks to Steve Lhomme)
• Add Missing Constructor (thanks to mcxiaoke)

• Fix Header View's being selectable (can cause FCs)
• Force ListView Footer to be the last visible item (#41)
• Fix not being able to Pull when the Empty View is show (#40)
• Add Japanese Translations (thanks to nagoya0)

• Properly fix not being able to Pull when the Empty View is show (#40)

• Fix bug where Pulling Up stopped working with ListView (#43)
• Fix bug where the Header/Footer's wouldn't be styled correctly on ListView (#42)
• Add new Listener, OnRefreshListener2 which allows you to listen for Pull Up/Downs separately.

• Changed the custom attributes to be prefixed with 'ptr'. Should fixed compatibility with ActionBarSherlock v4.

• Fixes for #44, #48, #49

• Fixed PullToRefreshWebView so that pulling from the bottom works (thanks nagoya0)
• Can now display last update label using then new setLastUpdatedLabel() method (thanks Peter Elliott)
• Strings are now separate for Pulling Up and Pulling Up views, necessary for certain languages. There also new label setter methods so you change each one separately.
• Bug fixes, including #66, #62 and #64

• Fix Background colour when using custom colour with ListView (#67)
• Fix bug where the ListView would also scroll to the bottom/top after refreshing (#67)
• Ability to change mode via a method call (#10)
• Ability to make filtering of touch events more lenient (setFilterTouchEvents)
• Fixed Copyright Notices on Source

• Stefano Dacchille
• Steve Lhomme
• Maxim Galkin

Licensed under the Apache License, Version 2.0