Android 上拉下拉的listVIew

实现原理

1.下拉刷新

通过onTouchEvent判断手势，来改变listview的header。header的状态共4种，自己定义为：

NONE（对应图1）：初始状态

PULL（对应图2）：下拉状态，此时松开会还原到状态NONE，并不进行刷新

RELEASE（对应图3）：同样是下拉状态，但此刻松开会执行刷新，进入状态REFRESHING

REFRESHING（对应图4）：正在执行刷新，刷新结束后进入状态NONE。

header在四种状态切换时不仅改变内部组件，同时改变自身的大小。改变内部组件的体现比如，箭头的朝上或者朝下，文字提示的变化，等待圆圈的显示与否。大小的改变其实就是高度的改变，NONE时header高度为0,RELEASE时header的高度由你下拉的程度决定。

2.加载更多

在listview滑动停止后，判断listview的最后一个item是否已经显示，如果显示说明listview已经滑动到了最底部，这时便触发加载更多的方法，方法结束根据结果改变footer。

3.回调方法

在类中定义了两个接口OnRefreshListener和OnLoadListener，用来定义和提供加载数据的方法，具体实现则交给它们的实现类去做。

/**
 * 支持下拉刷新和上拉加载的列表
 *
 * @author Internet
 */
publicclass XListViewextends ListView implements OnScrollListener {

    private float mLastY = -1; // save event y
    private Scroller mScroller; // used for scroll back
    private OnScrollListener mScrollListener; // user's scrolllistener

    // the interface to trigger refreshand load more.
    private XListViewListener mListViewListener;

    // -- header view
    private XListViewHeader mHeaderView;
    // header view content, use it to calculatethe Header's height. And hide it
    // when disable pull refresh.
    private RelativeLayout mHeaderViewContent;
    private TextView mHeaderTimeView;
    private int mHeaderViewHeight; // header view'sheight
    private boolean mEnablePullRefresh= true;
    private boolean mPullRefreshing = false; // is refreashing.

    // -- footer view
    private XListViewFooter mFooterView;
    private boolean mEnablePullLoad = false;
    private boolean mPullLoading;
    private boolean mIsFooterReady = false;

    // total list items, used to detect is atthe bottom of listview.
    private int mTotalItemCount;

    // for mScroller, scroll back from headeror footer.
    private int mScrollBack;
    private final static int SCROLLBACK_HEADER= 0;
    private final static int SCROLLBACK_FOOTER= 1;

    private final static int SCROLL_DURATION = 400; // scroll back duration
    private final static int PULL_LOAD_MORE_DELTA= 50; // when pull up>= 50px
    // at bottom, trigger
    // load more.
    private final static float OFFSET_RADIO = 1.8f; // support iOS likepull
    // feature.

    public XListView(Context context) {
        super(context);
        initWithContext(context);
    }

    public XListView(Context context, AttributeSetattrs) {
        super(context, attrs);
        initWithContext(context);
    }

    public XListView(Context context, AttributeSetattrs, int defStyle) {
        super(context, attrs, defStyle);
        initWithContext(context);
    }

    private void initWithContext(Context context) {
        mScroller = new Scroller(context, new DecelerateInterpolator());
        // XListView need the scroll event, and itwill dispatch the event to
        // user's listener (as a proxy).
        super.setOnScrollListener(this);

        // init header view
        mHeaderView = new XListViewHeader(context);
        mHeaderViewContent = (RelativeLayout)mHeaderView
                .findViewById(R.id.xlistview_header_content);
        mHeaderTimeView = (TextView) mHeaderView
                .findViewById(R.id.xlistview_header_time);
        addHeaderView(mHeaderView);

        // init footer view
        mFooterView = new XListViewFooter(context);

        // init header height
        mHeaderView.getViewTreeObserver().addOnGlobalLayoutListener(
                new OnGlobalLayoutListener(){
                    @Override
                    public void onGlobalLayout() {
                        mHeaderViewHeight= mHeaderViewContent.getHeight();
                       getViewTreeObserver()
                               .removeGlobalOnLayoutListener(this);
                    }
                });
    }

    @Override
    public void setAdapter(ListAdapter adapter) {
        // make sure XListViewFooter is the lastfooter view, and only add once.
        if (mIsFooterReady == false && mEnablePullLoad) {
            mIsFooterReady = true;
            addFooterView(mFooterView);
        }
        super.setAdapter(adapter);
    }

    /**
     * 设置底部显示的文本提示
     *
     * @param show       显示更多
     * @param show_touch 松开载入更多
     */
    public void setFooterText(String show, Stringshow_touch) {
        mFooterView.setFooterText(show, show_touch);
    }

    /**
     * enable or disable pull downrefresh feature.
     *
     * @param enable
     */
    public void setPullRefreshEnable(boolean enable) {
        mEnablePullRefresh = enable;
        if (!mEnablePullRefresh) { // disable, hide the content
            mHeaderViewContent.setVisibility(View.INVISIBLE);
        } else {
            mHeaderViewContent.setVisibility(View.VISIBLE);
        }
    }

    /**
     * enable or disable pull up loadmore feature.
     *
     * @param enable
     */
    public void setPullLoadEnable(boolean enable) {
        mEnablePullLoad = enable;
        mHeaderView.setOnClickListener(null);// no touching.
        if (!mEnablePullLoad) {
            mFooterView.hide();
            mFooterView.setOnClickListener(null);
        } else {
            mPullLoading = false;
            mFooterView.show();
            mFooterView.setState(XListViewFooter.STATE_NORMAL);
            // both "pull up" and"click" will invoke load more.
            mFooterView.setOnClickListener(new OnClickListener(){
                @Override
                public void onClick(View v) {
                    startLoadMore();
                }
            });
        }
    }

    /**
     * 设置为弹性列表（前提是未启用footer）
     */
    public void setSpring() {
        //尾部处理
        if (mEnablePullLoad)
            return;
        mEnablePullLoad = true;
        mFooterView.show();
        mFooterView.setFooterSpring();
        //头部处理
        if (mEnablePullRefresh)
            return;
        mEnablePullRefresh = true;
        mHeaderViewContent.setVisibility(View.GONE);
    }

    /**
     * 仅设置为弹性列表
     * (就是给版本低，项目多的一个单独的优化，项目多必须超过一屏幕)
     *
     * @param low_and_more 系统版本低，并且项目多（会启用上滑，否则低版本是禁用上滑的）
     */
    public void setSpringOnly(boolean low_and_more) {
        setPullRefreshEnable(false);
        if (android.os.Build.VERSION.SDK_INT >= 19) {//受到系统版本影响
            setFooterDividersEnabled(false);
            setSpring();
        } else {
            setSpring();
            //项目多时，注释此行即可（项目过少会出现双线），所以通过禁用上滑来隐藏
            if (!low_and_more)
                setPullLoadEnable(false);
        }
        setXListViewListener(new XListViewListener(){
            public void onRefresh() {
                stopRefresh();
            }

            public void onLoadMore() {
                stopLoadMore();
            }
        });
    }

    /**
     * 仅设置为弹性列表（默认）
     */
    public void setSpringOnly() {
        setSpringOnly(false);
    }

    /**
     * stop refresh, reset header view.
     */
    public void stopRefresh() {
        if (mPullRefreshing == true) {
            mPullRefreshing = false;
            resetHeaderHeight();
        }
    }

    /**
     * stop load more, reset footer view.
     */
    public void stopLoadMore() {
        if (mPullLoading == true) {
            mPullLoading = false;
            mFooterView.setState(XListViewFooter.STATE_NORMAL);
        }
    }

    /**
     * set last refresh time
     *
     * @param time
     */
    //我把布局中的gone了
    public void setRefreshTime(String time) {
        mHeaderTimeView.setText(time);
    }

    private void invokeOnScrolling() {
        if (mScrollListener instanceof OnXScrollListener){
            OnXScrollListener l =(OnXScrollListener) mScrollListener;
            l.onXScrolling(this);
        }
    }

    private void updateHeaderHeight(float delta) {
        if (mEnablePullRefresh && !mPullRefreshing) {
            mHeaderView.setVisiableHeight((int) delta
                    + mHeaderView.getVisiableHeight());
            if (mHeaderView.getVisiableHeight() > mHeaderViewHeight) {
                mHeaderView.setState(XListViewHeader.STATE_READY);
            } else {
                mHeaderView.setState(XListViewHeader.STATE_NORMAL);
            }
        }
        setSelection(0); // scroll to topeach time
    }

    /**
     * reset header view's height.
     */
    private void resetHeaderHeight() {
        int height = mHeaderView.getVisiableHeight();
        if (height == 0) // not visible.
            return;
        // refreshing and header isn't shown fully.do nothing.
        if (mPullRefreshing && height<= mHeaderViewHeight) {
            return;
        }
        int finalHeight = 0; // default: scroll back to dismiss header.
        // is refreshing, just scrollback to show all the header.
        if (mPullRefreshing && height> mHeaderViewHeight) {
            finalHeight = mHeaderViewHeight;
        }
        mScrollBack = SCROLLBACK_HEADER;
        mScroller.startScroll(0, height, 0, finalHeight - height,
                SCROLL_DURATION);
        // trigger computeScroll
        invalidate();
    }

    private void updateFooterHeight(float delta) {
        int height = mFooterView.getBottomMargin() + (int) delta;
        if (mEnablePullLoad && !mPullLoading) {
            if (height > PULL_LOAD_MORE_DELTA) { // height enough toinvoke load
                // more.
                mFooterView.setState(XListViewFooter.STATE_READY);
            } else {
                mFooterView.setState(XListViewFooter.STATE_NORMAL);
            }
        }
        mFooterView.setBottomMargin(height);

        // setSelection(mTotalItemCount - 1); //scroll to bottom
    }

    private void resetFooterHeight() {
        int bottomMargin = mFooterView.getBottomMargin();
        if (bottomMargin > 0) {
            mScrollBack = SCROLLBACK_FOOTER;
            mScroller.startScroll(0, bottomMargin, 0, -bottomMargin,
                    SCROLL_DURATION);
            invalidate();
        }
    }

    private void startLoadMore() {
        mPullLoading = true;
        mFooterView.setState(XListViewFooter.STATE_LOADING);
        if (mListViewListener != null) {
            mListViewListener.onLoadMore();
        }
    }

    @Override
    public boolean onTouchEvent(MotionEvent ev) {
        if (mLastY == -1) {
            mLastY = ev.getRawY();
        }

        switch (ev.getAction()) {
            case MotionEvent.ACTION_DOWN:
                mLastY = ev.getRawY();
                break;
            case MotionEvent.ACTION_MOVE:
                final float deltaY =ev.getRawY() - mLastY;
                mLastY = ev.getRawY();
                if (getFirstVisiblePosition()== 0
                        && (mHeaderView.getVisiableHeight() > 0 || deltaY > 0)) {
                    // the first itemis showing, header has shown or pull down.
                    updateHeaderHeight(deltaY/ OFFSET_RADIO);
                    invokeOnScrolling();
                } else if (getLastVisiblePosition()== mTotalItemCount- 1
                        && (mFooterView.getBottomMargin()> 0 || deltaY < 0)) {
                    // last item,already pulled up or want to pull up.
                    updateFooterHeight(-deltaY/ OFFSET_RADIO);
                }
                break;
            default:
                mLastY = -1; // reset
                if (getFirstVisiblePosition()== 0) {
                    // invoke refresh
                    if (mEnablePullRefresh
                            && mHeaderView.getVisiableHeight()> mHeaderViewHeight) {
                        mPullRefreshing = true;
                        mHeaderView.setState(XListViewHeader.STATE_REFRESHING);
                        if (mListViewListener != null) {
                            mListViewListener.onRefresh();
                        }
                    }
                    resetHeaderHeight();
                }
                if (getLastVisiblePosition()== mTotalItemCount- 1) {
                    // invoke loadmore.
                    if (mEnablePullLoad
                            && mFooterView.getBottomMargin()> PULL_LOAD_MORE_DELTA) {
                        startLoadMore();
                    }
                    resetFooterHeight();
                }
                break;
        }
        return super.onTouchEvent(ev);
    }

    @Override
    public void computeScroll() {
        if (mScroller.computeScrollOffset()) {
            if (mScrollBack == SCROLLBACK_HEADER) {
                mHeaderView.setVisiableHeight(mScroller.getCurrY());
            } else {
                mFooterView.setBottomMargin(mScroller.getCurrY());
            }
            postInvalidate();
            invokeOnScrolling();
       }
        super.computeScroll();
    }

    @Override
    public void setOnScrollListener(OnScrollListener l) {
        mScrollListener = l;
    }

    @Override
    public void onScrollStateChanged(AbsListView view, int scrollState) {
        if (mScrollListener != null) {
            mScrollListener.onScrollStateChanged(view,scrollState);
        }
    }

    /**
     * @param view             视图
     * @param firstVisibleItem目前可见的第一条是列表中的第几条
     * @param visibleItemCount目前可见的条数
     * @param totalItemCount   列表总的条数
     */
    @Override
    public void onScroll(AbsListView view, int firstVisibleItem,
                         int visibleItemCount, int totalItemCount) {
        // send to user's listener
        mTotalItemCount = totalItemCount;
        if (mScrollListener != null) {
            mScrollListener.onScroll(view,firstVisibleItem, visibleItemCount,
                    totalItemCount);
        }
    }

    public void setXListViewListener(XListViewListener l){
        mListViewListener = l;
    }

    /**
     * you can listenListView.OnScrollListener or this one. it will invoke
     * onXScrolling when header/footerscroll back.
     */
    public interface OnXScrollListener extends OnScrollListener {
        public void onXScrolling(View view);
    }

    /**
     * implements this interface to getrefresh/load more event.
     */
    public interface XListViewListener{
        public void onRefresh();

        public void onLoadMore();
    }
}