Android下拉刷新上拉加载控件(适用于所有View）

Android下拉刷新上拉加载控件

在 Android 开发中，下拉刷新和上拉加载是一种常用的业务需求。为了方便开发者使用，有很多第三方控件可以供我们使用。本文将介绍一款适用于所有 View 的下拉刷新上拉加载控件。

控件介绍

本控件基于 Android 的 NestedScrolling 机制来实现下拉刷新和上拉加载，可以使用在 RecyclerView、ListView、GridView、WebView 等所有支持 NestedScrolling 的控件上。

特性：

• 支持下拉刷新和上拉加载
• 下拉刷新和上拉加载可以同时使用
• 支持自定义刷新和加载布局
• 支持自动加载和手动加载
• 支持设置下拉刷新和上拉加载的触发距离
• 支持下拉刷新和上拉加载的监听事件
• 适用于所有支持 NestedScrolling 的控件

控件使用

1. 引入依赖

在项目的 build.gradle 文件中加入以下依赖:

dependencies {
    implementation 'com.github.imtianx:PullRefreshLayout:1.1.0'
}

2. 使用控件

在布局文件中添加控件：

<?xml version="1.0" encoding="utf-8"?>
<com.imtianx.pullrefreshlayout.PullRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pull_refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</com.imtianx.pullrefreshlayout.PullRefreshLayout>

在代码中初始化控件：

pullRefreshLayout = findViewById(R.id.pull_refresh_layout);

// 添加下拉刷新监听器
pullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
    @Override
    public void onRefresh() {
        // 处理下拉刷新业务逻辑
    }
});

// 添加上拉加载监听器
pullRefreshLayout.setOnLoadMoreListener(new PullRefreshLayout.OnLoadMoreListener() {
    @Override
    public void onLoadMore() {
        // 处理上拉加载业务逻辑
    }
});

// 自动下拉刷新
pullRefreshLayout.autoRefresh();

3. 自定义刷新和加载布局

如果默认的刷新和加载布局不符合你的需求，你可以自定义布局，只需要实现 RefreshView 和 LoadMoreView 接口即可。例如，以下代码实现了一个自定义的刷新布局：

public class MyRefreshView extends View implements RefreshView {

    // 这里省略了实现方法，具体可以参考 PullRefreshLayout 源码

}

在代码中使用自定义布局：

pullRefreshLayout.setRefreshView(new MyRefreshView());

4. 其他配置项

在代码中可以配置其他的选项，例如，设置触发刷新的距离：

pullRefreshLayout.setRefreshTriggerDistance(100);

示例说明

示例1：下拉刷新

下面是一个简单的示例，演示了如何在 ListView 上使用控件来实现下拉刷新:

1. 在 build.gradle 文件中添加依赖：

dependencies {
    implementation 'com.github.imtianx:PullRefreshLayout:1.1.0'
}

1. 在布局文件中添加控件：

<?xml version="1.0" encoding="utf-8"?>
<com.imtianx.pullrefreshlayout.PullRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pull_refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</com.imtianx.pullrefreshlayout.PullRefreshLayout>

1. 在代码中初始化控件并设置监听：

pullRefreshLayout = findViewById(R.id.pull_refresh_layout);
listView = findViewById(R.id.list_view);

// 添加下拉刷新监听器
pullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
    @Override
    public void onRefresh() {
        // 模拟刷新
        new Handler().postDelayed(new Runnable() {
            @Override
            public void run() {
                // 结束刷新
                pullRefreshLayout.finishRefresh();
            }
        }, 2000);
    }
});

// 设置适配器
ArrayAdapter<String> adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, data);
listView.setAdapter(adapter);

1. 运行程序，下拉列表即可触发刷新。

示例2：上拉加载

下面是一个简单的示例，演示了如何在 RecyclerView 上使用控件来实现上拉加载:

1. 在 build.gradle 文件中添加依赖：

dependencies {
    implementation 'com.github.imtianx:PullRefreshLayout:1.1.0'
}

1. 在布局文件中添加控件：

<?xml version="1.0" encoding="utf-8"?>
<com.imtianx.pullrefreshlayout.PullRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pull_refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</com.imtianx.pullrefreshlayout.PullRefreshLayout>

1. 在代码中初始化控件并设置监听：

pullRefreshLayout = findViewById(R.id.pull_refresh_layout);
recyclerView = findViewById(R.id.recycler_view);

// 添加上拉加载监听器
pullRefreshLayout.setOnLoadMoreListener(new PullRefreshLayout.OnLoadMoreListener() {
    @Override
    public void onLoadMore() {
        // 模拟加载
        new Handler().postDelayed(new Runnable() {
            @Override
            public void run() {
                // 结束加载
                pullRefreshLayout.finishLoadMore();
            }
        }, 2000);
    }
});

// 设置适配器
adapter = new MyRecyclerAdapter(data);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(adapter);

1. 运行程序，上拉列表即可触发加载。

总结

本文介绍了一款适用于所有 View 的下拉刷新上拉加载控件，并演示了两个简单的示例。开发者可以根据自己的需求自由定制刷新和加载布局，控件使用简单方便，适合各种项目和业务需求。