Android-PullToRefresh 使用教程

Android-PullToRefresh 使用教程

Android-PullToRefreshDEPRECATED项目地址:https://gitcode.com/gh_mirrors/an/Android-PullToRefresh

项目介绍

Android-PullToRefresh 是一个实现下拉刷新和上拉加载功能的开源库。它支持多种常见的视图类型，如 ListView、ExpandableListView、GridView、WebView、ScrollView、HorizontalScrollView 和 ViewPager 等。该库使用方便，可以通过简单的配置实现复杂的刷新和加载操作。

项目快速启动

1. 添加依赖

首先，在项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.github.chrisbanes:Android-PullToRefresh:2.1.1'
}

2. 在布局文件中添加 PullToRefresh 控件

以 PullToRefreshListView 为例，在布局文件中添加如下代码：

<com.handmark.pulltorefresh.library.PullToRefreshListView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pull_to_refresh_listview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

3. 在 Activity 中初始化和设置监听器

在 Activity 中初始化 PullToRefreshListView 并设置监听器：

import com.handmark.pulltorefresh.library.PullToRefreshListView;
import com.handmark.pulltorefresh.library.PullToRefreshBase;

public class MainActivity extends AppCompatActivity {
    private PullToRefreshListView pullToRefreshListView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        pullToRefreshListView = findViewById(R.id.pull_to_refresh_listview);
        pullToRefreshListView.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener<ListView>() {
            @Override
            public void onRefresh(PullToRefreshBase<ListView> refreshView) {
                // 执行刷新操作
                new RefreshTask().execute();
            }
        });
    }

    private class RefreshTask extends AsyncTask<Void, Void, Void> {
        @Override
        protected Void doInBackground(Void... params) {
            // 模拟数据刷新
            try {
                Thread.sleep(2000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            return null;
        }

        @Override
        protected void onPostExecute(Void result) {
            // 刷新完成，通知控件
            pullToRefreshListView.onRefreshComplete();
        }
    }
}

应用案例和最佳实践

1. 自定义刷新视图

可以通过继承 PullToRefreshBase 类并重写相关方法来自定义刷新视图。例如，自定义一个带有动画效果的刷新头部：

public class CustomPullToRefreshListView extends PullToRefreshListView {
    public CustomPullToRefreshListView(Context context) {
        super(context);
    }

    @Override
    protected LoadingLayout createLoadingLayout(Context context, Mode mode, TypedArray attrs) {
        return new CustomLoadingLayout(context, mode, attrs);
    }
}

2. 结合 RecyclerView 使用

虽然 PullToRefresh 库本身不直接支持 RecyclerView，但可以通过自定义实现类似效果：

public class PullToRefreshRecyclerView extends PullToRefreshBase<RecyclerView> {
    public PullToRefreshRecyclerView(Context context) {
        super(context);
    }

    @Override
    public Orientation getPullToRefreshScrollDirection() {
        return Orientation.VERTICAL;
    }

    @Override
    protected RecyclerView createRefreshableView(Context context, AttributeSet attrs) {
        RecyclerView recyclerView = new RecyclerView(context, attrs);
        return recyclerView;
    }

    @Override
    protected boolean isReadyForPullStart() {
        return isFirstItemVisible();
    }

    private boolean isFirstItemVisible() {
        final RecyclerView.Adapter adapter = getRefreshableView().getAdapter();
        if (null == adapter || adapter.getItemCount() == 0) {
            return true;
        } else {
            if (getFirstVisiblePosition() == 0) {
                return getRefreshableView().getChild

Android-PullToRefreshDEPRECATED项目地址:https://gitcode.com/gh_mirrors/an/Android-PullToRefresh