1 概念
Android-PullToRefresh 框架是一个实现View下拉刷新的开源框架.
2 配置项目
- 从Github上下载需要的文件.
Github下载地址 : https://github.com/chrisbanes/Android-PullToRefresh
- 将下载的压缩包进行解压文件结构如下 :
--> Android-PullToRefresh-maste
--> extras
--> samples
--> library (我们需要的.)
- 新建项目,直接将解压得到的
library拷贝到项目的根目录(在Android Studio中)下.其实也就是将library作为一个单独的Module.
// 此时的项目结构
--> 项目
--> app
--> library // 新拷贝的文件
... // 其他
- 修改项目的
settings.gradle文件. 增加include ':library'
// 修改前
include ':app'
// 修改后
include ':app'
include ':library'
- 在新建的
libraryModule 下面创建build.gradle文件.内容如下.
注意 :
compileSdkVersion和buildToolsVersion要修改你本机上可用的.
apply plugin:'com.android.library'
android {
compileSdkVersion 24
buildToolsVersion "24.0.3"
sourceSets {
main {
manifest.srcFile 'AndroidManifest.xml'
java.srcDirs = ['src']
resources.srcDirs = ['src']
aidl.srcDirs = ['aidl']
renderscript.srcDirs = ['src']
res.srcDirs = ['res']
assets.srcDirs = ['assets']
}
}
}
- 修改
appModule 中的build.gradle文件 增加依赖compile project(':library')
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:24.2.1'
// 新增加的
compile project(':library')
testCompile 'junit:junit:4.12'
}
- 同步项目
注意 : 如果是Android 6.0 以上同步会提示
FloatMath不可用的错误. 使用Math替换即可.
3 使用
在布局文件中使用 PullToRefreshListView
布局文件
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
android:id="@+id/activity_main"
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="10dp"
tools:context="com.wsj.test.pulltorefreshtestone.MainActivity">
<!-- PullToRefresh 测试的ListView -->
<com.handmark.pulltorefresh.library.PullToRefreshListView
android:id="@+id/id_lv_test"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:dividerHeight="1px"
android:divider="#FF1493"
android:background="#FFFFE0"/>
</LinearLayout>
Activity 中设置下拉刷新监听
- 使用
setOnRefreshListener设置刷新监听, - 使用
OnRefreshListener回调在onRefresh方法中触发加载数据操作.实现下拉监听. - 使用
AsyncTask实现加载数据 . - 加载完后已经记得调用
id_lv_test.onRefreshComplete();,否则将无法结束加载.
注意 : 加载数据时间不要太短,否则会出现无法
onRefreshComplete()失效的情况. 并且一定要在主线程中中.
public class MainActivity extends AppCompatActivity {
PullToRefreshListView id_lv_test;
// 数据组合
private List<String> mList = new ArrayList<String>(){
{
add("语文");
add("数学");
add("计算机");
}
};
private ArrayAdapter<String> mLvAdapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取控件
id_lv_test = (PullToRefreshListView) findViewById(R.id.id_lv_test);
// 设置适配器
mLvAdapter = new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,mList);
id_lv_test.setAdapter(mLvAdapter);
// 设置下拉刷新监听.
id_lv_test.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener<ListView>() {
@Override
public void onRefresh(PullToRefreshBase<ListView> refreshView) {
// 使用 AsyncTask 加载新数据.
new AsyncTask<Void,Void,Void>(){
@Override
protected Void doInBackground(Void... params) {
// 子线程加载数据,模拟延时 3s
SystemClock.sleep(3 * 1000);
mList.add("新数据 - " + mLvAdapter.getCount());
return null;
}
@Override
protected void onPostExecute(Void aVoid) {
// 这是在主线程. 通知 ListView 更新数据.
id_lv_test.onRefreshComplete();
}
}.execute();
}
});
}
}
实现上拉和下拉刷新
步骤和单独的下拉刷线基本一样试试 监听者 使用 OnRefreshListener2 实现其中的两个方法分别表示上拉 和 下拉.
// 设置刷新模式
/*
* 设置PullToRefresh刷新模式
* BOTH:上拉刷新和下拉刷新都支持
* DISABLED：禁用上拉下拉刷新
* PULL_FROM_START:仅支持下拉刷新（默认）
* PULL_FROM_END：仅支持上拉刷新
* MANUAL_REFRESH_ONLY：只允许手动触发
**/
id_lv_test.setMode(PullToRefreshBase.Mode.BOTH);
// 设置上下刷新 使用 OnRefreshListener2
id_lv_test.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {
@Override
public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
// 主线程
Log.d(TAG,"下拉动作 : " + Thread.currentThread().getId());
// TODO : 实现数据加载逻辑.
// 模拟数据加载,,加载时间不要太短 否则,会出现一直刷新的情况.
id_lv_test.postDelayed(new Runnable() {
@Override
public void run() {
id_lv_test.onRefreshComplete();
}
},50);
}
@Override
public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
Log.d(TAG,"上拉动作");
// TODO : 实现数据加载逻辑.
id_lv_test.postDelayed(new Runnable() {
@Override
public void run() {
id_lv_test.onRefreshComplete();
}
},50);
}
});
// 设置PullRefreshListView上提加载时的加载提示
id_lv_test.getLoadingLayoutProxy(false,true).setPullLabel("上拉加载更多.");
id_lv_test.getLoadingLayoutProxy(false,true).setRefreshingLabel("正在加载数据...");
id_lv_test.getLoadingLayoutProxy(false,true).setReleaseLabel("松开加载更多...");
// 设置PullRefreshListView下拉加载时的加载提示
id_lv_test.getLoadingLayoutProxy(true, false).setPullLabel("下拉刷新...");
id_lv_test.getLoadingLayoutProxy(true, false).setRefreshingLabel("正在刷新...");
id_lv_test.getLoadingLayoutProxy(true,false).setReleaseLabel("松开刷新...");
