瀑布流ListView

前言　　

　　终于忙完了一段时间，现在前段时间写的一个瀑布流ListView到想法分享下，这个东西是扩展自Listview，当列表内容拉到最后后触发刷新操作，以便抓取更多到数据。

先贴下整个代码，先有个整体到概念，然后再进一步细聊。代码如下

package cn.bitlove.waterfalllistview.widget;

import cn.bitlove.waterfalllistview.R;
import android.content.Context;
import android.util.AttributeSet;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AbsListView;
import android.widget.FrameLayout;
import android.widget.AbsListView.OnScrollListener;
import android.widget.ListView;

/**
 * 瀑布流Listview
 * */
public class WaterfallListview extends ListView implements OnScrollListener {

    final private String tag="WaterfallListView";
    private Context mContext;
    private LayoutInflater mInflater;        
    final int REFRESH_IDEL=0;        //空闲中
    final int REFRESH_PREPARE=1;    //准备刷新
    final int REFRESH_ING=2;        //刷新中
    final int REFRESH_End=3;        //刷新完成
    private int mRefreshState = REFRESH_IDEL;        //刷新状态
    private int mScrollState;        //滚动状态

    private FrameLayout mFooterLayout;    //ListView 的footer
    private View mListFoot;        //底部刷新区域

    private IOnRefresh mRefreshListener = null;    //刷新监听器
    public WaterfallListview(Context context) {
        super(context);
    }
    public  WaterfallListview(Context context, AttributeSet attrs) {
        super(context,attrs);
        init();
    }
    @Override
    public void onScrollStateChanged(AbsListView view, int scrollState) {
        mScrollState = scrollState;
    }

    @Override
    public void onScroll(AbsListView view, int firstVisibleItem,
            int visibleItemCount, int totalItemCount) {
        if(totalItemCount==0 || mScrollState==SCROLL_STATE_IDLE){
            return;
        }
        //最后一个item
        int lastItemCount = firstVisibleItem+visibleItemCount;
        if(lastItemCount==totalItemCount && mRefreshState==REFRESH_IDEL){
            prepareRefresh();
            doRefresh();
        }
    }

    private void init(){
        mContext = getContext();
        mInflater = (LayoutInflater) mContext.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
        initFooter();
        setOnScrollListener(this);
    }
    /**
     * 设置刷新器
     * */
    public void setRefreshListener(IOnRefresh refresher){
        mRefreshListener = refresher;
    }

    /**
     * 初始化底部刷新内容
     * */
    private void initFooter(){
        mListFoot = mInflater.inflate(R.layout.foot_waterfall_listview, null);
        mFooterLayout = new FrameLayout(mContext);
        addFooterView(mFooterLayout);
    }
    /**
     * 准备刷新
     * */
    private void prepareRefresh(){
        //Log.i(tag,"prepareRefresh");
        mRefreshState = REFRESH_PREPARE;
        ViewGroup vg = (ViewGroup) mListFoot.getParent();
        if(vg!=null){
            vg.removeView(mListFoot);
        }

        mFooterLayout.addView(mListFoot);

        if(mRefreshListener!=null){
            mRefreshListener.beforeRefresh();
        }
    }
    /**
     * 执行刷新
     * */
    private void doRefresh(){
        //Log.i(tag,"doRefresh");
        mRefreshState=REFRESH_ING;

        if(mRefreshListener!=null){
            mRefreshListener.doRefresh();
        }

    }
    /**
     * 完成刷新
     * */
    public void completeRefresh(){
        mRefreshState = REFRESH_IDEL;
        mFooterLayout.removeAllViews();
    }
    
    public interface IOnRefresh{
        public void beforeRefresh();
        /**
         * 执行完doRefresh操作后，必须调用completeRefresh方法来清理刷新状态
         * */
        public void doRefresh();
    }
}

底部视图　　

　　为了完成滑动到底部后触发刷新事件，为此给Listview增加了一个底部view，代码如下

<?xml version="1.0" encoding="utf-8"?>
<!-- waterfallListview 底部刷新区域 -->
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" 
    >
    
<TextView 
    android:layout_height="40dp"
    android:layout_width="match_parent"
    android:text="加载更多数据..."
    android:gravity="center"
    />
</RelativeLayout>

很简单，只是用来展示一个获取状态。

接口

　　 除此之外，还增加了一个内部接口，IOnRefresh,表示相关事件，代码如下所示

public interface IOnRefresh{
        public void beforeRefresh();
        /**
         * 执行完doRefresh操作后，必须调用completeRefresh方法来清理刷新状态
         * */
        public void doRefresh();
}

 这两个方法的含义根据名字来看就很清楚了，beforeRefresh，在刷新之前调用，让client有机会做一些事情；doRefresh，真正执行刷新到部分，另外需要注意到时候，当执行完刷新到时候，要掉用下widget的completeRefresh方法来清理刷新状态，标示真正执行完了刷新操作

completeRefresh方法

很简单到一个方法，有两个主要功能，一是置状态，二是取消listview底部的view，代码如下

public void completeRefresh(){
        mRefreshState = REFRESH_IDEL;
        mFooterLayout.removeAllViews();
}

设计思路

　　大体到内容就是以上那些，下面来看下实现的思路。
　　为了完成这个功能，增加了一个刷新状态mRefreshState,这个状态用来表示当前控件所处到刷新状态，以便在不同状态下做不同到处理，其有以下四个状态

final int REFRESH_IDEL=0;        //空闲中
final int REFRESH_PREPARE=1;    //准备刷新
final int REFRESH_ING=2;        //刷新中
final int REFRESH_End=3;        //刷新完成

然后整个widget到逻辑就是控制这四个状态，然后在不同到状态执行不同到操作，比如在执行beforeRefresh函数时，此时状态处于REFRESH_PREPARE，
当执行doRefresh时状态处于REFRESH_ING，当我们调用completeRefresh后，状态改为REFRESH_IDEL，其实当初设计的时候还希望有一个REFRESH_End状态，但是实现过程中没有发现此状态的用处，暂时为保留状态，以便以后扩充用。

控制状态

控制状态，主要是在onScroll函数中操作的，代码如下

@Override
    public void onScroll(AbsListView view, int firstVisibleItem,
            int visibleItemCount, int totalItemCount) {
        if(totalItemCount==0 || mScrollState==SCROLL_STATE_IDLE){
            return;
        }
        //最后一个item
        int lastItemCount = firstVisibleItem+visibleItemCount;
        if(lastItemCount==totalItemCount && mRefreshState==REFRESH_IDEL){
            prepareRefresh();
            doRefresh();
        }
    }

主要实现思路就是监测最后一个item是否出现。

　　好了，到此为止，主要到思路就完了。

后记

　　这个控件到Demo程序下载地址：https://github.com/xiaoai-opensource/WaterfallListview

　　有需要到朋友可以前去下载查看