如何实现点击ListView行时勾选/取消勾选Checkbox？

这个需求其实挺常见的，我之前也做过类似的功能，核心就是要解决两个问题：一是让ListView的行点击事件能正常触发，二是准确管理每行Checkbox的选中状态。下面给你一步步拆解实现方法：

1. 先搞定Item布局（避免焦点冲突） #

首先要注意：默认情况下Checkbox会抢占焦点，导致ListView的行点击事件无法触发。所以我们需要在布局里给Checkbox（以及行内其他可获取焦点的控件）设置android:focusable="false"，让整个行能接收点击事件。

示例list_item.xml布局：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:padding="16dp"
    android:clickable="true" <!-- 可选，增强点击反馈 -->
    android:background="?android:attr/selectableItemBackground">

    <TextView
        android:id="@+id/tv_content"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Sample Item"
        android:focusable="false"/>

    <CheckBox
        android:id="@+id/cb_check"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:focusable="false"/> <!-- 关键：不让Checkbox抢焦点 -->
</LinearLayout>

2. 自定义Adapter管理选中状态 #

我们需要一个自定义Adapter来维护每行Checkbox的选中状态，这里推荐用SparseBooleanArray（比HashMap更适合int类型的位置索引）来存储状态，避免复用Item时状态混乱。

示例CustomAdapter代码：

public class CustomAdapter extends BaseAdapter {
    private Context mContext;
    private List<String> mItemList;
    private SparseBooleanArray mCheckedStates; // 记录每个位置的选中状态

    public CustomAdapter(Context context, List<String> itemList) {
        mContext = context;
        mItemList = itemList;
        mCheckedStates = new SparseBooleanArray();
        // 初始化所有状态为未选中
        for (int i = 0; i < mItemList.size(); i++) {
            mCheckedStates.put(i, false);
        }
    }

    @Override
    public int getCount() {
        return mItemList.size();
    }

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

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

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext).inflate(R.layout.list_item, parent, false);
            holder = new ViewHolder();
            holder.tvContent = convertView.findViewById(R.id.tv_content);
            holder.cbCheck = convertView.findViewById(R.id.cb_check);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        // 设置Item内容
        holder.tvContent.setText(mItemList.get(position));
        // 根据存储的状态设置Checkbox
        holder.cbCheck.setChecked(mCheckedStates.get(position));

        return convertView;
    }

    // 切换指定位置的选中状态并刷新列表
    public void toggleChecked(int position) {
        boolean currentState = mCheckedStates.get(position);
        mCheckedStates.put(position, !currentState);
        notifyDataSetChanged();
    }

    // ViewHolder优化列表性能
    private static class ViewHolder {
        TextView tvContent;
        CheckBox cbCheck;
    }
}

3. 给ListView设置点击事件 #

最后一步就是给ListView绑定OnItemClickListener，点击时调用Adapter的toggleChecked方法切换对应位置的Checkbox状态。

示例Activity代码：

public class MainActivity extends AppCompatActivity {
    private ListView mListView;
    private CustomAdapter mAdapter;

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

        mListView = findViewById(R.id.list_view);
        // 模拟测试数据
        List<String> testData = new ArrayList<>();
        for (int i = 1; i <= 20; i++) {
            testData.add("List Item " + i);
        }
        mAdapter = new CustomAdapter(this, testData);
        mListView.setAdapter(mAdapter);

        // 绑定行点击事件
        mListView.setOnItemClickListener((parent, view, position, id) -> {
            // 切换当前行的Checkbox状态
            mAdapter.toggleChecked(position);
        });
    }
}

额外注意点 #

• 如果你的Item里有Button等其他可获取焦点的控件，同样要设置android:focusable="false"，否则行点击事件会失效。
• 如果你需要批量操作（比如全选/反选），可以在Adapter里增加对应的方法，直接修改SparseBooleanArray的状态后调用notifyDataSetChanged()即可。

内容的提问来源于stack exchange，提问作者Koen Amant