Android列表组件ListView使用详解之滑动事件监听

给ListView增加滑动监听事件，便于在每一个事件触发点增加我们的处理逻辑，如ListView中的子项上滑动、下滑动、滑动到底部等。

设置ListView的滑动监听事件：

testLv.setOnScrollListener(this);

当前类实现了AbslistView.OnScrollListener。

需要在当前类中重写以下两个方法：

@Override
    public void onScrollStateChanged(AbsListView view, int scrollState) {
        switch (scrollState) {
            case SCROLL_STATE_IDLE://停止滑动
                Log.w(TAG, "停止滑动");
                break;
            case SCROLL_STATE_TOUCH_SCROLL://正在滑动
                Log.w(TAG, "正在滑动");
                break;
            case SCROLL_STATE_FLING://滑动ListView离开后，由于惯性继续滑动
                Log.w(TAG, "滑动ListView离开后，由于惯性继续滑动");
                break;
        }
    }

    @Override
    public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
        /*
        ListView滑动时，一直回调该方法
        firstVisibleItem：当前能看到的第一个子项的ID（从0开始）
        visibleItemCount：当前能看到的子项的总数，包含未完整显示的子项，比如只显示了一小部分的子项
        totalItemCount：所有子项的总数
         */
        Log.e(TAG, "当前能看到的第一个子项的ID（从0开始）= " + firstVisibleItem);
        Log.e(TAG, "当前能看到的子项的总数 = " + visibleItemCount);
        Log.e(TAG, "所有子项的总数 = " + totalItemCount);

        //可用于底部加载更多数据的判断逻辑
        if (firstVisibleItem + visibleItemCount == totalItemCount && totalItemCount > 0) {
            Log.e(TAG, "滑动到ListView的最后一个子项");
        }

        //判断ListView的滑动方向
        if (this.firstVisibleItem == firstVisibleItem) {
            Log.e(TAG, "未发生滑动");
        } else if (this.firstVisibleItem > firstVisibleItem) {
            Log.e(TAG, "发生下滑");
        } else {
            Log.e(TAG, "发生上滑");
        }
        this.firstVisibleItem = firstVisibleItem;
    }

完整代码：

package net.oschina.git.zhaikun.androiddeveloped.activitys;

import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.MotionEvent;
import android.view.View;
import android.widget.AbsListView;
import android.widget.Button;
import android.widget.ListView;

import net.oschina.git.zhaikun.androiddeveloped.R;
import net.oschina.git.zhaikun.androiddeveloped.adapter.ListViewDemoAdapter;

import java.util.ArrayList;
import java.util.List;

/**
 * Created by zhaikun68 on 2018/3/5.
 * 

 * ListView演示Demo
 */
public class ListViewDemoActivity extends AppCompatActivity implements View.OnClickListener, View.OnTouchListener, AbsListView.OnScrollListener {

    private static final String TAG = "ListViewDemoActivity";//日志打印标记

    private ListView testLv;//ListView组件
    private Button updateDataBtn;//动态加载数据组件

    private List dataList = new ArrayList<>();//存储数据
    private ListViewDemoAdapter listViewDemoAdapter;//ListView的数据适配器

    private int firstVisibleItem = 0;//记录ListView滑动过程中，当前可视区域第一个子项的ID

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_listview_demo);

        initView();//初始化组件
        initData();//初始化数据
    }

    /**
     * 初始化组件
     */
    private void initView() {
        testLv = (ListView) findViewById(R.id.test_lv);
        updateDataBtn = (Button) findViewById(R.id.update_data_btn);

        updateDataBtn.setOnClickListener(this);//动态加载数据组件的点击事件
        testLv.setOnTouchListener(this);//设置ListView组件的触摸事件
        testLv.setOnScrollListener(this);//设置ListView组件的滑动监听事件
    }

    /**
     * 初始化数据
     */
    private void initData() {
        //初始化10项数据
        for (int i = 1; i <= 20; i++) {
            dataList.add("显示内容" + i);
        }

        //设置ListView的适配器
        listViewDemoAdapter = new ListViewDemoAdapter(this, dataList);
        testLv.setAdapter(listViewDemoAdapter);
        //testLv.setSelection(4);
        //数据为空时显示的提示信息
        testLv.setEmptyView(findViewById(R.id.empty_tv));
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.update_data_btn://动态加载列表数据
                dataList.add("动态加载的数据项");
                //通知ListView更改数据源
                if (listViewDemoAdapter != null) {
                    listViewDemoAdapter.notifyDataSetChanged();
                    testLv.setSelection(dataList.size() - 1);//设置显示列表的最后一项
                } else {
                    listViewDemoAdapter = new ListViewDemoAdapter(this, dataList);
                    testLv.setAdapter(listViewDemoAdapter);
                    testLv.setSelection(dataList.size() - 1);
                }
                break;
        }
    }

    @Override
    public boolean onTouch(View v, MotionEvent event) {
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN://触摸屏幕时，只执行一次
                Log.i(TAG, "执行触摸时的操作");
                break;
            case MotionEvent.ACTION_MOVE://触摸到屏幕时，反复执行
                Log.i(TAG, "执行移动时的操作");
                break;
            case MotionEvent.ACTION_UP://离开屏幕时，只执行一次
                Log.i(TAG, "执行触摸离开时的操作");
                break;
        }
        return false;
    }

    @Override
    public void onScrollStateChanged(AbsListView view, int scrollState) {
        switch (scrollState) {
            case SCROLL_STATE_IDLE://停止滑动
                Log.w(TAG, "停止滑动");
                break;
            case SCROLL_STATE_TOUCH_SCROLL://正在滑动
                Log.w(TAG, "正在滑动");
                break;
            case SCROLL_STATE_FLING://滑动ListView离开后，由于惯性继续滑动
                Log.w(TAG, "滑动ListView离开后，由于惯性继续滑动");
                break;
        }
    }

    @Override
    public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
        /*
        ListView滑动时，一直回调该方法
        firstVisibleItem：当前能看到的第一个子项的ID（从0开始）
        visibleItemCount：当前能看到的子项的总数，包含未完整显示的子项，比如只显示了一小部分的子项
        totalItemCount：所有子项的总数
         */
        Log.e(TAG, "当前能看到的第一个子项的ID（从0开始）= " + firstVisibleItem);
        Log.e(TAG, "当前能看到的子项的总数 = " + visibleItemCount);
        Log.e(TAG, "所有子项的总数 = " + totalItemCount);

        //可用于底部加载更多数据的判断逻辑
        if (firstVisibleItem + visibleItemCount == totalItemCount && totalItemCount > 0) {
            Log.e(TAG, "滑动到ListView的最后一个子项");
        }

        //判断ListView的滑动方向
        if (this.firstVisibleItem == firstVisibleItem) {
            Log.e(TAG, "未发生滑动");
        } else if (this.firstVisibleItem > firstVisibleItem) {
            Log.e(TAG, "发生下滑");
        } else {
            Log.e(TAG, "发生上滑");
        }
        this.firstVisibleItem = firstVisibleItem;
    }
}

对应的布局文件：

列表数据适配器：

package net.oschina.git.zhaikun.androiddeveloped.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.TextView;

import net.oschina.git.zhaikun.androiddeveloped.R;

import java.util.List;

/**
 * Created by zhaikun68 on 2018/3/5.
 * 

 * ListView演示Demo中的数据适配器
 */
public class ListViewDemoAdapter extends BaseAdapter {

    private Context context;//上下文对象
    private List dataList;//ListView显示的数据

    /**
     * 构造器
     *
     * @param context  上下文对象
     * @param dataList 数据
     */
    public ListViewDemoAdapter(Context context, List dataList) {
        this.context = context;
        this.dataList = dataList;
    }

    @Override
    public int getCount() {
        return dataList == null ? 0 : dataList.size();
    }

    @Override
    public Object getItem(int position) {
        return dataList.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder viewHolder;
        //判断是否有缓存
        if (convertView == null) {
            convertView = LayoutInflater.from(context).inflate(R.layout.item_listview_demo, null);
            viewHolder = new ViewHolder(convertView);
            convertView.setTag(viewHolder);
        } else {
            //得到缓存的布局
            viewHolder = (ViewHolder) convertView.getTag();
        }

        //设置图片
        viewHolder.pictureImg.setImageResource(R.mipmap.ic_launcher);
        //设置内容
        viewHolder.contentTv.setText(dataList.get(position));

        return convertView;
    }

    /**
     * ViewHolder类
     */
    private final class ViewHolder {

        ImageView pictureImg;//图片
        TextView contentTv;//内容

        /**
         * 构造器
         *
         * @param view 视图组件（ListView的子项视图）
         */
        ViewHolder(View view) {
            pictureImg = (ImageView) view.findViewById(R.id.picture_img);
            contentTv = (TextView) view.findViewById(R.id.content_tv);
        }
    }
}

列表子项对应的布局文件：