自定义组件之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。