打造Android万能上拉下拉刷新框架--XRefreshView（三）

转载请注明出处：http://blog.csdn.net/footballclub/

打造Android万能上拉下拉刷新框架–XRefreshView（一）

打造Android万能上拉下拉刷新框架–XRefreshView（二）

XRefreshView更新说明

这段时间一直有朋友给我反馈，让我帮忙解决问题，我汇总了下，有以下几种：

1. 处理listview滑动删除与XRefreshView的冲突

2. 处理viewpager和XRefreshView的冲突

3. listview滑动到底部自动加载更多

4. 刷新时，不让里面的listview上下滑动

5. 自定义headerview和footerview

6. 配置自定义头部广告位

除了广告位的都已经完成了。除此之外，我还对默认的header和footer做了ui上的优化，特别地，鉴于Recylerview的强大，我还针对Recylerview做了特别的适配，接下来先看效果图，在模拟器上录的，有点卡卡的。

效果图

更新详细

1.处理横向移动与XRefreshView的冲突

如果需要在手指横向移动的时候，让XRefreshView不拦截事件，

xRefreshView.setMoveForHorizontal(true);

可以调用setMoveForHorizontal并传入true即可。

2.滑动到底部自动加载更多

目前只做了Abslistview和Recylerview的

xRefreshView.setAutoLoadMore(false);

true会自动加载更多，false则相反。传入false的话，如果是listview，需要上拉才能加载更多，如果是Recylerview，则会需要点击才能加载更多。就像这样

点击加载更多涉及到自定义footerview，到后面再说，这里先放着。

3.刷新时，不让里面的列表上下滑动

如果刷新时不想让里面的列表滑动，可以这么设置

xRefreshView.setPinnedContent(true);

4.支持按钮点击开始刷新

XRefreshView不仅支持手势下拉刷新，也支持按钮点击开始刷新，

xRefreshView.startRefresh();

可以在activity的onResume()中调用，也可以在按钮的点击事件中调用。

5.设置Abslistview和Recylerview的滚动监听事件

如果你有设置Abslistview和Recylerview滚动监听事件的需要的话，就不能直接使用Abslistview和Recylerview的setOnScrollListener方法了，因为为了实现自动加载更多的功能，监听已经被XRefreshView使用了，所以这时候需要使用XRefreshView提供的设置滚动监听的方法

    /**
     * 设置Abslistview的滚动监听事件
     *
     * @param listener
     */
    public void setOnAbsListViewScrollListener(OnScrollListener scrollListener) {
        mContentView.setOnAbsListViewScrollListener(scrollListener);
    }

    /**
     * 设置Recylerview的滚动监听事件
     */
    public void setOnRecyclerViewScrollListener(
            RecyclerView.OnScrollListener scrollListener) {
        mContentView.setOnRecyclerViewScrollListener(scrollListener);
    }

6.设置加载更多

如果希望在加载更多数据的时候，能在没有新数据的时候，隐藏footerview的话，

new Handler().postDelayed(new Runnable() {
                    public void run() {
                        //模拟数据加载完成
                        if (mLoadCount >= 3) {
                            xRefreshView.setLoadComplete(true);
                        }
                        adapter.insert(new Person("More ", "21"),
                                adapter.getAdapterItemCount());
                        adapter.insert(new Person("More ", "21"),
                                adapter.getAdapterItemCount());
                        adapter.insert(new Person("More ", "21"),
                                adapter.getAdapterItemCount());
                        mLoadCount++;
                        //刷新完成必须调用此方法停止加载
                        xRefreshView.stopLoadMore();
                    }
                }, 1000);

当调用xRefreshView.setLoadComplete(true)以后，就会隐藏footerview；如果过段时间又有新的数据了，可以调用xRefreshView.setLoadComplete(false)，这样就又可以正常加载更多了。

7.其他一些属性的设置

/**
     * 设置headerview回滚的时间，默认400毫秒
     *
     * @param during
     */
    public void setScrollDuring(int during) {
        SCROLL_DURATION = during;
    }

    /**
     * 设置阻尼系数，建议使用默认的
     *
     * @param ratio
     *            默认 1.8
     */
    public void setDampingRatio(float ratio) {
        OFFSET_RADIO = ratio;
    }

    /**
     * 设置当下拉刷新完成以后，headerview和footerview被固定的时间
     * 注:考虑到ui效果，只有时间大于1s的时候，footerview被固定的效果才会生效
     *
     * @param pinnedTime
     */
    public void setPinnedTime(int pinnedTime) {
        mPinnedTime = pinnedTime;
        mContentView.setPinnedTime(pinnedTime);
    }

8.XRefreshView提供的监听


    public interface XRefreshViewListener {
        /**
         * 下拉刷新的回调
         */
        public void onRefresh();
        /**
         * 上拉加载更多的回调
         */
        public void onLoadMore();

        /**
         * 用户手指释放的监听回调
         *
         * @param direction
         *            >0: 下拉释放，<0:上拉释放 注：暂时没有使用这个方法
         */
        public void onRelease(float direction);

        /**
         * 获取headerview显示的高度与headerview高度的比例
         *
         * @param offset
         *            移动距离和headerview高度的比例，范围是0~1，0：headerview完全没显示
         *            1：headerview完全显示
         * @param offsetY
         *            headerview移动的距离
         */
        public void onHeaderMove(double offset, int offsetY);
    }

9.自定义header和footer

9.1.自定义header

实现IHeaderCallBack接口，并继承View就可以自定义headerview了

/**
 * 提供自定义headerview的接口
 *
 * @author [email protected]
 *
 */
public interface IHeaderCallBack {
    /**
     * 正常状态
     */
    public void onStateNormal();

    /**
     * 准备刷新
     */
    public void onStateReady();

    /**
     * 正在刷新
     */
    public void onStateRefreshing();

    /**
     * 刷新结束
     */
    public void onStateEnd();

    /**
     * 获取headerview显示的高度与headerview高度的比例
     *
     * @param offset
     *            移动距离和headerview高度的比例，范围是0~1，0：headerview完全没显示 1：headerview完全显示
     * @param offsetY
     *            headerview移动的距离
     */
    public void onHeaderMove(double offset, int offsetY);

    /**
     * 设置显示上一次刷新的时间
     *
     * @param lastRefreshTime
     *            上一次刷新的时间
     */
    public void setRefreshTime(long lastRefreshTime);

    /**
     * 隐藏footerview
     */
    public void hide();

    /**
     * 显示footerview
     */
    public void show();

    /**
     * 获得headerview的高度,如果不想headerview全部被隐藏，就可以只返回一部分的高度
     *
     * @return
     */
    public int getHeaderHeight();
}

这里需要介绍下几种headerview的状态

Created with Rapha?l 2.1.0normalnormalreadyreadyrefreshingrefreshingfinishfinishheader移动的距离大于header的高度header移动的距离小于header的高度松手进入refreshing状态刷新完成进入finish状态，此过程header被固定着此时header开始回弹，至完全隐藏时，状态变成normal

XRefreshView提供了不同状态的回调，方便开发者根据状态来改变headerview的显示，同时为了提供更加强大的支持，XRefreshView提供了onHeaderMove(double offset, int offsetY)回调来返回当前headerview移动的信息，这样能够更加自由的定制headerview。在继承了View并实现了IHeaderCallBack接口以后，需要调用下面这个方法来设置自定义headerview

refreshView.setCustomHeaderView(new CustomHeader(this));

9.2.自定义footer

自定义footer和自定义header类似，都同样要实现接口，自定义footer要实现 IFooterCallBack接口

public interface IFooterCallBack {
    /**
     * 当不是到达底部自动加载更多的时候，需要自己写点击事件
     * @param xRefreshViewListener
     */
    public void callWhenNotAutoLoadMore(XRefreshViewListener xRefreshViewListener);
    /**
     * 正常状态，例如需要点击footerview才能加载更多，主要是到达底部不自动加载更多时会被调用
     */
    public void onStateReady();
    /**
     * 正在刷新
     */
    public void onStateRefreshing();
    /**
     * 刷新结束
     */
    public void onStateFinish();
    /**
     * 已无更多数据
     */
    public void onStateComplete();
    /**
     * 隐藏footerview
     */
    public void hide();
    /**
     * 显示footerview
     */
    public void show();
    /**
     * 获得footerview的高度
     * @return
     */
    public int getFooterHeight();
}

footerview的状态流程分成两种

1.当到达底部自动加载更多：

1.1.还有更多数据

refreshing–>finish–>refreshing

1.2.已无更多数据

refreshing–>finish–>complete

2.当到达底部不自动加载更多：

2.1.还有更多数据

ready–>refreshing–>finish–>refreshing

2.2.已无更多数据

ready–>refreshing–>finish–>complete

其中，当不是到达底部自动加载更多的时候，需要自己写点击事件，就像这样：

@Override
    public void callWhenNotAutoLoadMore(final XRefreshViewListener listener) {
        mClickView.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                if(listener!=null){
                    listener.onLoadMore();
                    onStateRefreshing();
                }
            }
        });
    }

给footer设置点击事件，在点击事件中直接回调onLoadMore，并且进入刷新状态。

还有就是footer的show和hide方法不能向header那样：

header
/**
     * hide footer when disable pull load more
     */
    public void hide() {
        setVisibility(View.GONE);
    }

    public void show() {
        setVisibility(View.VISIBLE);
    }

直接gone会给列表底部留下空白，所以应该这样

public void hide() {
        LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView
                .getLayoutParams();
        lp.height = 0;
        mContentView.setLayoutParams(lp);
    }

    public void show() {
        LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView
                .getLayoutParams();
        lp.height = LayoutParams.WRAP_CONTENT;
        mContentView.setLayoutParams(lp);
    }

最后也需要通过下面这个方法来设置自定义footerview

refreshView.setCustomFooterView(new CustomFooterView(this));

10.Recylerview的Adapter

Recylerview的adapter必须继承自UltimateViewAdapter，具体用法可以参照demo中的SimpleAdapter，此外，给Recylerview设置自定义footerview和设置自定义headerview是不一样的，设置自定义headerview是通过XRefreshView来设置的，但是设置自定义footerview确是通过UltimateViewAdapter来设置的，具体如下：

UltimateViewAdapter
/**
     * Using a custom LoadMoreView
     *
     * @param customview
     *            the inflated view
     */
    public void setCustomLoadMoreView(View footerView) {
        if (footerView instanceof IFooterCallBack) {
            customLoadMoreView = footerView;
        } else {
            throw new RuntimeException(
                    "footerView must be implementes IFooterCallBack!");
        }
    }

......

    adapter.setCustomLoadMoreView(footerView);

注：目前上拉加载更多只支持Linearlayoutmanager，我还在找解决办法。

最后

XRefreshView托管于github，点此前往下载，欢迎start or fork。

参考的项目

在开发过程中有参考一些很不错的开源项目，分别是

  1. UltimateRecyclerView
  2. android-Ultra-Pull-To-Refresh

版权声明：本文为博主原创文章，未经博主允许不得转载。

时间： 2024-10-13 12:05:18

打造Android万能上拉下拉刷新框架--XRefreshView（三）的相关文章

打造android万能上拉下拉刷新框架——XRefreshView (二)

打造Android万能上拉下拉刷新框架--XRefreshView(一) 打造Android万能上拉下拉刷新框架--XRefreshView(三) 一.前言 自从上次发表了打造android万能上拉下拉刷新框架--XRefreshView (一)之后,期间的大半个月一直都非常忙.可是我每天晚上下班以后都有在更新和维护XRefreshView,也依据一些朋友的意见攻克了一些问题,这次之所以写这篇文章.是由于XRefreshView已经到了一个功能相对可靠和稳定的一个阶段.以下我会介绍下Xrefre

打造android万能上拉下拉刷新框架——XRefreshView (一)

一.写在开头的话 之所以写这个东西是因为项目中有用到,需要给stickylistheaders加个刷新,其实就是个framelayout里面有个listview的自定义view布局,但是一些知名的刷新框架我试了下都不支持,pulltoRefresh和XListView都是自己实现了一个可刷新的view,然后让我们来直接使用这个可刷新的view,从而达到可以上拉下拉刷新的目的.我这个需求需要的是一个我告诉他什么时候需要刷新他就能帮我刷新的框架,也就是说不管什么view,只要能告诉框架自己什么时候需

练习使用XRecyclerView，可上拉下拉刷新。

1 package com.lixu.testxrecyclerview; 2 import android.support.v7.app.AppCompatActivity; 3 import android.os.Bundle; 4 import android.support.v7.widget.StaggeredGridLayoutManager; 5 import android.view.LayoutInflater; 6 import android.view.View; 7 im

iOS 上拉下拉刷新

1 把李明杰的MJRfresh文件夹拖到工程中 2 然后引入头文件 3 在.m 文件中设置两个变量 4 在viewDidLoad里调用两个方法 5 实现需要调用的两个方法 iOS 上拉下拉刷新,布布扣,bubuko.com

ListView实现上拉下拉刷新加载功能

第一步.首先在你项目中创建一个包存放支持下拉刷新和上拉加载的类: 第二步.需要把两个动画导入进来,实现180度旋转与360度旋转: 第三步.需要把支持的下拉与上拉显示的隐藏加载布局给导入进来 第四步.需要添加strings.xml与colors.xml文件的内容添加到项目里面: strings.xml <string name="pull_to_refresh">下拉刷新</string> <string name="release_to_ref

iOS 上拉下拉刷新简单实现代码

一般说到上拉刷新下拉刷新,很多人可能想到的是一个第三方开源框架EGORefresh,下面说下,如何自己写代码实现. UITableView本身是一个UIScrollView,所以UITableView可以实现UIScrollView的代理方法.上拉和下拉刷新无非是UIScrollView偏移到一定程度调用刷新方法. 实现- (void)scrollViewDidScroll:(UIScrollView*)scrollView代理方法即可.代码如下: (void)scrollViewDidScro

UITableableview上拉下拉刷新

#import "ViewController.h" //加入引用的头文件 #import "UIView+MJExtension.h" #import "MJRefresh.h" static const CGFloat MJDuration = 2.0; @interface ViewController ()<UITableViewDelegate,UITableViewDataSource> @property (nonato

android118 上拉下拉刷新列表listView实现

032 Android智能下拉刷新框架-SmartRefreshLayout+RecyclerView的使用

1.SmartRefreshLayout介绍 SmartRefreshLayout的目标是打造一个强大,稳定,成熟的下拉刷新框架,并集成各种的炫酷.多样.实用.美观的Header和Footer. 正如名字所说,SmartRefreshLayout是一个“聪明”或者“智能”的下拉刷新布局,由于它的“智能”,它不只是支持所有的View,还支持多层嵌套的视图结构. 它继承自ViewGroup 而不是FrameLayout或LinearLayout,提高了性能. 也吸取了现在流行的各种刷新布局的优点,包