当前位置：首页 > news >正文

PullToRefresh使用示例：XListView下拉刷新与上拉加载完整指南

news 2026/8/2 22:43:41

PullToRefresh使用示例：XListView下拉刷新与上拉加载完整指南

【免费下载链接】PullToRefresh根据Maxwin的XListView改造而来，完善下拉刷新上拉加载更多的功能并实现自动刷新以及自动加载等功能，并增加对ScrollView的支持。原XListView参考链接：https://github.com/Maxwin-z/XListView-Android项目地址: https://gitcode.com/gh_mirrors/pull/PullToRefresh

PullToRefresh是一个基于Maxwin的XListView改造的Android下拉刷新库，它不仅完善了下拉刷新和上拉加载更多功能，还实现了自动刷新、自动加载等特性，并增加了对ScrollView的支持。本指南将通过简单步骤和实际界面展示，帮助你快速掌握这个强大的下拉刷新组件。

项目快速开始

首先需要将项目代码克隆到本地环境：

git clone https://gitcode.com/gh_mirrors/pull/PullToRefresh

项目核心实现位于以下目录结构中：

主界面入口：PullToRefresh/src/main/java/com/markmao/pulltorefresh/ui/MainActivity.java
XListView实现：PullToRefresh/src/main/java/com/markmao/pulltorefresh/ui/XListViewActivity.java
XScrollView实现：PullToRefresh/src/main/java/com/markmao/pulltorefresh/ui/XScrollViewActivity.java
自定义组件：PullToRefresh/src/main/java/com/markmao/pulltorefresh/widget/

应用主界面概览

应用启动后，首先展示的是主界面，提供了两个功能入口：

ListView示例：展示XListView的下拉刷新和上拉加载功能
ScrollView示例：展示XScrollView的下拉刷新效果

XListView使用详解

1. 基本配置与初始化

XListViewActivity是实现列表下拉刷新的核心类，它实现了XListView.IXListViewListener接口来处理刷新和加载事件：

public class XListViewActivity extends Activity implements XListView.IXListViewListener { private XListView mListView; private ArrayAdapter<String> mAdapter; private Handler mHandler; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.act_list_view); initView(); } private void initView() { mHandler = new Handler(); mListView = (XListView) findViewById(R.id.list_view); // 启用下拉刷新 mListView.setPullRefreshEnable(true); // 启用上拉加载 mListView.setPullLoadEnable(true); // 启用自动加载 mListView.setAutoLoadEnable(true); // 设置监听器 mListView.setXListViewListener(this); // 设置刷新时间 mListView.setRefreshTime(getTime()); mAdapter = new ArrayAdapter<String>(this, R.layout.vw_list_item, items); mListView.setAdapter(mAdapter); } }

2. 下拉刷新功能实现

下拉刷新功能通过实现onRefresh()方法完成，当用户下拉列表时会触发此方法：

@Override public void onRefresh() { mHandler.postDelayed(new Runnable() { @Override public void run() { // 模拟网络请求延迟 mIndex = ++mRefreshIndex; items.clear(); geneItems(); // 生成新数据 mAdapter.notifyDataSetChanged(); onLoad(); // 完成刷新 } }, 2500); }

下图展示了下拉刷新的交互状态，顶部会显示"松开可以刷新"的提示文字和箭头图标：

3. 上拉加载更多实现

上拉加载更多功能通过实现onLoadMore()方法完成，当用户滑动到列表底部时会触发此方法：

@Override public void onLoadMore() { mHandler.postDelayed(new Runnable() { @Override public void run() { // 模拟加载延迟 geneItems(); // 添加更多数据 mAdapter.notifyDataSetChanged(); onLoad(); // 完成加载 } }, 2500); } private void onLoad() { mListView.stopRefresh(); // 停止刷新动画 mListView.stopLoadMore(); // 停止加载动画 mListView.setRefreshTime(getTime()); // 更新刷新时间 }

下图展示了上拉加载的交互状态，底部会显示"松开载入更多"的提示文字：

XScrollView使用示例

除了列表视图，PullToRefresh还提供了对ScrollView的支持，实现了类似的下拉刷新功能。XScrollViewActivity演示了这一用法：

public class XScrollViewActivity extends Activity implements XScrollView.IXScrollViewListener { private XScrollView mScrollView; private View mContentView; private void initView() { mScrollView = (XScrollView) findViewById(R.id.scroll_view); mScrollView.setPullRefreshEnable(true); mScrollView.setPullLoadEnable(false); // ScrollView默认不启用上拉加载 mScrollView.setXScrollViewListener(this); mScrollView.setRefreshTime(getTime()); } @Override public void onRefresh() { mHandler.postDelayed(new Runnable() { @Override public void run() { // 刷新数据逻辑 mScrollView.stopRefresh(); mScrollView.setRefreshTime(getTime()); } }, 2500); } }

下图展示了XScrollView的刷新状态，顶部会显示"正在刷新..."的提示文字和进度动画：