pulltorefresh使用介绍,实现下拉刷新上拉加载更多

在Android开发中,上拉刷新,下拉加载在很多项目中被需求着,这个功能具体怎么实现呢,很简单,用一个第三方插件chrisbanes写的android-PullToRefresh库即可了,或者谷歌官方推出的SwipeRefreshLayout。
  个人觉得PullToRefresh比较好用,并且可扩展,在外面很多企业项目中被使用了,所以我介绍下这个插件的用法。

  PullToRefresh支持系数:

  1. 支持下拉与上拉
  2. 支持listfragment
  3. 支持众多控件,如:    
    • ListView
    • ExpandableListView
    • GridView
    • WebView
    • ScrollView
    • HorizontalScrollView
    • ViewPager

下载库路径:https://github.com/chrisbanes/Android-PullToRefresh

下载完成,导入项目,在你自己的项目library里面添加刚引入的项目。

不扯废话,直接步入介绍使用的正题!

Ps:它支持的控件比较多,不过会一个其他的就能举一反三的使用出来,我们以使用比较多的listview的下拉上拉刷新为实例。


一:写布局

1 <com.handmark.pulltorefresh.library.PullToRefreshListView
2         android:id="@+id/plistview"
3         android:layout_width="match_parent"
4         android:layout_height="match_parent"
5         />

二:绑定控件

复制代码
1 private PullToRefreshListView pListView;// PullToRefreshListView控件对象
2 @Override
3 protected void onCreate(Bundle savedInstanceState) {
4     super.onCreate(savedInstanceState);
5     setContentView(R.layout.listview_layout);
6     pListView = (PullToRefreshListView) findViewById(R.id.plistview);
7 }
复制代码

三: 为listview绑定适配器

复制代码
1 ArrayList<String> arrayList = new ArrayList<String>();
2 // 初始化适配器
3 adapter = new ArrayAdapter<String>(this, R.layout.item_layout, R.id.tv_item_name, arrayList);
4 adapter.add("snail");
5 adapter.add("_snail");
6 adapter.add("__snail");
7 adapter.add("___snail");
8 // 绑定适配器
9 pListView.setAdapter(adapter);
复制代码

 

四:设置刷新模式

复制代码
1 /*
2  * 设置PullToRefresh刷新模式
3  * BOTH:上拉刷新和下拉刷新都支持
4  * DISABLED:禁用上拉下拉刷新
5  * PULL_FROM_START:仅支持下拉刷新(默认)
6  * PULL_FROM_END:仅支持上拉刷新
7  * MANUAL_REFRESH_ONLY:只允许手动触发
8  * */
9 pListView.setMode(Mode.PULL_FROM_START);
复制代码

五:绑定刷新监听事件

复制代码
// 设置刷新监听
pListView.setOnRefreshListener(new OnRefreshListener<ListView>() {
    @Override
    public void onRefresh(PullToRefreshBase<ListView> refreshView) {
        String str = DateUtils.formatDateTime(MainActivity.this, System.currentTimeMillis(), DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);
        //设置刷新标签
        pListView.getLoadingLayoutProxy().setRefreshingLabel("正在刷新");
        //设置下拉标签
        pListView.getLoadingLayoutProxy().setPullLabel("下拉刷新");
        //设置释放标签
        pListView.getLoadingLayoutProxy().setReleaseLabel("释放开始刷新");
        //设置上一次刷新的提示标签
        refreshView.getLoadingLayoutProxy().setLastUpdatedLabel("最后更新时间:" + str);
        //加载数据操作
        new MyTask().execute();
    }
});
复制代码

其中加载数据代码(我这是本地的一般都是网络获取数据):

复制代码
 1 private class MyTask extends AsyncTask<Void, Void, ArrayList<String>> {
 2 
 3         @Override
 4         protected ArrayList<String> doInBackground(Void... params) {
 5             try {
 6                 Thread.sleep(2000);//睡眠2秒,延迟加载数据
 7             } catch (InterruptedException e) {
 8                 e.printStackTrace();
 9             }
10             ArrayList<String> mArrayList = new ArrayList<String>();
11             for (int i = 0; i < 5; i++) {
12                 counter++;
13                 mArrayList.add("-----" + String.valueOf(counter) + "-------");
14             }
15             return mArrayList;
16         }
17 
18         @Override
19         protected void onPostExecute(ArrayList<String> result) {
20             for (String string : result) {
21                 adapter.add(string);
22             }
23             pListView.onRefreshComplete();//数据加载到适配器完成后,刷新完成,
24             super.onPostExecute(result);
25         }
26 
27     }
复制代码

Ps:pListView.onRefreshComplete();在数据加载完成一定要调用这个方法,否则界面刷新那块头部会一直在。

就这简简单单的五部就可以下拉刷新了。效果图如下

但是我们的需求还有个上拉加载更多,这个怎么做呢,只需要把我们的第四部和第五部小小修改下,就可以支持上拉加载更多了。

首先》我们讲我们第四部的模式调为 BOTH

然后》在puutorefresh库的基类文件PullToRefreshBase添加一个判别是上拉还是下拉的方法,代码如下

复制代码
1     //判别头部是否展示出来,如果展示出来代表下拉使得头部展示。true为下拉
2     public boolean isShownHeader() {
3         return getHeaderLayout().isShown();
4     }
5     //判别低部是否展示出来,如果展示出来代表上拉使得低部展示。true为上拉
6     public boolean isShownFooter() {
7         return getFooterLayout().isShown();
8     }
复制代码

最后》修改我们的监听事件

复制代码
 1 // 设置刷新监听
 2 pListView.setOnRefreshListener(new OnRefreshListener<ListView>() {
 3     @Override
 4     public void onRefresh(PullToRefreshBase<ListView> refreshView) {
 5 
 6         String str = DateUtils.formatDateTime(MainActivity.this, System.currentTimeMillis(), DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);
 7         // 下拉刷新 业务代码
 8         if (refreshView.isShownHeader()) {
 9             pListView.getLoadingLayoutProxy().setRefreshingLabel("正在刷新");
10             pListView.getLoadingLayoutProxy().setPullLabel("下拉刷新");
11             pListView.getLoadingLayoutProxy().setReleaseLabel("释放开始刷新");
12             refreshView.getLoadingLayoutProxy().setLastUpdatedLabel("最后更新时间:" + str);
13             new MyTask().execute();
14         } 
15         // 上拉加载更多 业务代码
16         if(refreshView.isShownFooter()) {
17             pListView.getLoadingLayoutProxy().setRefreshingLabel("正在加载");
18             pListView.getLoadingLayoutProxy().setPullLabel("上拉加载更多");
19             pListView.getLoadingLayoutProxy().setReleaseLabel("释放开始加载");
20             refreshView.getLoadingLayoutProxy().setLastUpdatedLabel("最后加载时间:" + str);
21             new MyTask().execute();
22         }
23     }
24 });
25     
复制代码

就这样我们这个上拉下拉都支持了。效果图如下

另附代码:链接: http://pan.baidu.com/s/1qWOBTla 密码: 12w5

 

在上面一章,我们简介了PullToRefresh的使用了,我们都知道了,他是一个自 定义的控件,基本上每个自定义控件的都会有自己的属性,我们这章介绍下他的有哪些属性,所有的自定义控件的属性,我们需要现在res/values /attrs.xml去声明下,我介绍下,这个自定义控件有哪些属性

复制代码
<?xml version="1.0" encoding="utf-8"?>
<resources>

    <declare-styleable name="PullToRefresh">
        <!-- 设置刷新列表的背景色 -->
        <attr name="ptrRefreshableViewBackground" format="reference|color" />
        <!-- 设置下拉Header或者上拉Footer的背景色 -->
        <attr name="ptrHeaderBackground" format="reference|color" />
        <!-- 用于设置Header与Footer中文本的颜色 -->
        <attr name="ptrHeaderTextColor" format="reference|color" />
        <!-- 用于设置Header与Footer中上次刷新时间文本的颜色 -->
        <attr name="ptrHeaderSubTextColor" format="reference|color" />
        <!-- 刷新模式 -->
        <attr name="ptrMode">
            <flag name="disabled" value="0x0" /> <!-- 禁用下拉刷新 -->
            <flag name="pullFromStart" value="0x1" /> <!-- 仅支持下拉刷新 -->
            <flag name="pullFromEnd" value="0x2" /> <!-- 仅支持上拉刷新 -->
            <flag name="both" value="0x3" /> <!-- 上拉刷新和下拉刷新都支持 -->
            <flag name="manualOnly" value="0x4" /> <!-- 只允许手动触发 -->
            <!-- These last two are depreacted -->
            <flag name="pullDownFromTop" value="0x1" />
            <flag name="pullUpFromBottom" value="0x2" />
        </attr>
        <!-- 如果为true会在mPullRefreshListView中出现icon,右上角和右下角,挺有意思的 -->
        <attr name="ptrShowIndicator" format="reference|boolean" />
        <!-- 同时改变头部和底部的刷新图标 -->
        <attr name="ptrDrawable" format="reference" />
        <!-- 头部视图的刷新图标 -->
        <attr name="ptrDrawableStart" format="reference" />
        <!-- 底部视图的刷新图标 -->
        <attr name="ptrDrawableEnd" format="reference" />
        <attr name="ptrOverScroll" format="reference|boolean" />
        <!-- 分别设置拉Header或者上拉Footer中字体的类型颜色等等 -->
        <attr name="ptrHeaderTextAppearance" format="reference" />
        <attr name="ptrSubHeaderTextAppearance" format="reference" />
        <!-- flip(翻转动画), rotate(旋转动画) -->
        <attr name="ptrAnimationStyle">
            <flag name="rotate" value="0x0" />
            <flag name="flip" value="0x1" />
        </attr>
        <!-- 刷新的时候,是否允许ListView或GridView滚动 -->
        <attr name="ptrScrollingWhileRefreshingEnabled" format="reference|boolean" />
        <!-- 决定了Header,Footer以何种方式加入mPullRefreshListView,true为headView方式加入,就是滚动时刷新头部会一起滚动,false不能刷新 -->
        <attr name="ptrListViewExtrasEnabled" format="reference|boolean" />
        <!-- 拉的时候头部或者尾部的刷新图片,是否多次旋转,true多次,false只是旋转一周,在下拉,图片不会在跟着旋转 -->
        <attr name="ptrRotateDrawableWhilePulling" format="reference|boolean" />
        <!-- BELOW HERE ARE DEPRECEATED. DO NOT USE. -->
        <attr name="ptrAdapterViewBackground" format="reference|color" />
        <attr name="ptrDrawableTop" format="reference" />
        <attr name="ptrDrawableBottom" format="reference" />
    </declare-styleable>

</resources>
复制代码

以上就是他所有的属性了,具体怎么使用呢,我们只需要我们布局文件的头部加入:

xmlns:ptr="http://schemas.android.com/apk/res-auto"

然后就可以在pulltorefresh节点的xml文件使用它的属性,如:

 ptr:ptrMode="both"

这样,我们就设置了,这个pulltorefresh的模式是上拉下拉双支持的

 

posted @ 2015-01-14 17:22  东方小虾米  阅读(368)  评论(0编辑  收藏  举报