瀑布流ListView

时间:2023-03-09 14:14:16
瀑布流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

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