自定义组件之MoreListView

前言

本文针对自定义组件进行一些分析。还是那句老话“授之于鱼不如授之以渔”。今天要讲的是一个自定义的可以分页的ListView。

网上都讲了些ListView分页的方法，那么为什么我在这里还需要自己写一个呢？

①分页功能是很多时候都需要的；

②网上的很多代码和数据绑定在一起的，要使用的话还需要改些东西，更重要的是代码很啰嗦、很糟糕（当然只是个人风格问题，至少我是这么认为）；

③或者是功能太强大而我们仅仅是需要分页功能，但是又不好分离出来。

所以写个分页的listview就很有必要了，尤其是可以直接使用的listview。

效果图

说得再多都是苍白无力的理论，先给个效果图看看吧。

分析

这个组件看上去简单，不过需要处理的细节还是挺多的。首先要明确这个组件是做什么的。简单地讲就是做分页显示或分页加载的。那么需要考虑这两个问题：

1、什么时候需要分页？

那么什么时候需要分页呢，这个答案是很明朗的。当数据数量不能填满一屏的时候那么就不用分页。在这个组件中我是这么来定分页的：首次加载的数量大于一屏显示数量时那么就认为有分页的可能，滑动到底部就需要“more”这个按钮。

2、何时加载分页信息？

至于何时进行分页，这是这个组件的关键。理论上是滑动到listview最底部的时候就需要显示一个“more”按钮，点击后进行分页，但是实际上我们需要做一定的小改动，也就是提前加载，及还没有滑动到最底部就开始加载。这样看来主要的问题就落在了如何判断是否滑动到了最底部。这问题在代码中讨论吧。

代码实现

MoreListView 组件代码：

 /***********************************************************
  *@description : This class function is you can load more datas
  *
  * @create author : kwzhang
  * @create date   :2013-6-19
  * @modify author :
  * @modify date   :
  * @contact: vanezkw@163.com
  *
  **********************************************************/
 package com.example.demo;

 import android.content.Context;
 import android.util.AttributeSet;
 import android.view.View;
 import android.widget.AbsListView;
 import android.widget.Button;
 import android.widget.ListAdapter;
 import android.widget.ListView;

 /**
  * @author kwzhang
  *
  */
 public class MoreListView extends ListView {

     private View mFooter;
     private LoadingListener mListener;
     private boolean mShowMore = true;

     /**
      * @param context
      * @param attrs
      */
     public MoreListView(Context context, AttributeSet attrs) {
         super(context, attrs);
         initFooter(context);
     }

     /**
      * @param mListener
      *            the mListener to set
      */
     public void setListener(LoadingListener mListener) {
         this.mListener = mListener;
         setOnScrollListener(innerOnScrollListener);
     }

     /**
      * @return the mShowMore
      */
     public boolean isShowMore() {
         return mShowMore;
     }

     /**
      * @param mShowMore
      *            the mShowMore to set
      */
     public void setShowMore(boolean mShowMore) {
         this.mShowMore = mShowMore;
     }

     /**
      * @description :TODO
      * @author : kwzhang
      * @create :2013-6-19
      * @param context
      * @return :void
      */
     protected void initFooter(Context context, View footer) {
         if (null == footer) {
             Button bt = new Button(context);
             bt.setText("More ...");
             mFooter = bt;
         } else {
             mFooter = footer;
         }
         mFooter.setOnClickListener(new OnClickListener() {
             @Override
             public void onClick(View v) {
                 if (getFooterViewsCount() > 0) {
                     removeFooterView(mFooter);
                 }
                 if (null != mListener) {
                     mListener.loadingMore(MoreListView.this);
                 }
             }
         });
         addFooterView(mFooter);
     }

     private void initFooter(Context context) {
         initFooter(context, null);
     }

     @Override
     public void setAdapter(ListAdapter adapter) {
         super.setAdapter(adapter);
         removeFooterView(mFooter);
     }

     /**
      * @param context
      * @param attrs
      * @param defStyle
      */
     public MoreListView(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
         initFooter(context);
     }

     /**
      * @param context
      */
     public MoreListView(Context context) {
         super(context);
         initFooter(context);
     }

     private OnScrollListener innerOnScrollListener = new OnScrollListener() {
         @Override
         public void onScrollStateChanged(AbsListView view, int scrollState) {
             // mLastVisibleItemIndex+1 == getAdapter().getCount()时说明滑动到最底端。
             // mLastVisibleItemIndex+3 是为了在倒数第二个就开始预先加载。不过此方法是采样调用，不一定及时执行。
             if (mShowMore) {
                 int count = getAdapter().getCount();
                 if ((mVisibleItemCount < count) && ((mLastVisibleItemIndex + 3) >= count) && (getFooterViewsCount() == 0)) {
                     addFooterView(mFooter);
                 }
             }
         }

         private int mLastVisibleItemIndex;
         private int mVisibleItemCount = -1;

         @Override
         public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
             mLastVisibleItemIndex = firstVisibleItem + visibleItemCount - 1;

             mVisibleItemCount = visibleItemCount;

         }
     };

     public static interface LoadingListener {
         public void loadingMore(View view);
     }
 }

测试Demo Activity:

 package com.example.demo;

 import android.app.Activity;
 import android.os.Bundle;
 import android.view.View;
 import android.widget.ArrayAdapter;

 public class ActDemo extends Activity implements MoreListView.LoadingListener {

     private MoreListView listView;
     private ArrayAdapter<String> mAdapter;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         listView = (MoreListView) findViewById(R.id.listview);
         mAdapter = getAdapter();
         listView.setAdapter(mAdapter);
         listView.setListener(this);
     }

     private ArrayAdapter<String> getAdapter() {
         ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1);
         for (int i = 0; i < 20; i++) {
             adapter.add("测试数据" + i);
         }
         return adapter;
     }

     @Override
     public void loadingMore(View view) {
         for (int i = 0; i < 10; i++) {
             mAdapter.add("新数据" + i);
         }
         if (mAdapter.getCount() > 60) {
             listView.setShowMore(false);
         }
     }
 }

测试Demo XML布局：

<com.example.demo.MoreListView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/listview"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" />

从上面的测试demo中可以看出使用起来非常方便。

1、protected void initFooter(Context context, View footer)方法说明一下。这个方法是给外部提供传递view的，这个view就是显示“more”的那个view，传null的话就有个默认的Button。

2、public void setListener(LoadingListener mListener)需要分页的话就必须调用这个方法。点击“more”按钮的时候其实去调用了LoadingListener.loadingMore(View view)方法。你可以根据需要进行实现。

总结

这样的组件就比较简单实用，也没有太复杂的代码，一看就能懂。我们需要的不正是这样简单的代码吗。随便说一下如果你需要更强的的Listview的话可以去看看AmazingListView项目。下拉刷新你可以看看johannilsson-android-pulltorefresh项目

PS：对文中有不解之处欢迎交流，有什么好的建议也可以留言。留下个QQ学习群：196761677。