ListView中自定义Adapter含ImageButton时onItemClickListener失效，如何解决？

这个问题我之前开发时也碰到过，核心原因是ImageButton属于可获取焦点的控件，它会默认抢占ListView Item的焦点，导致Item本身的onItemClickListener无法触发。下面给你一套完整的解决方案，既能保留Item的单/多选功能，又能正常响应ImageButton的点击：

一、先解决Item点击失效的核心问题（布局层面） #

在你的ListView Item布局文件里，做两个关键设置：

1. 给Item的根布局添加属性：

android:descendantFocusability="blocksDescendants"

这个属性的作用是让根布局拦截所有子控件的焦点请求，确保Item本身能接收到点击事件。

2. 给ImageButton添加属性（可选，但更稳妥）：

android:focusable="false"
android:focusableInTouchMode="false"

直接禁用ImageButton获取焦点的能力，彻底避免它抢占Item的焦点。

示例Item布局代码：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:descendantFocusability="blocksDescendants"
    android:orientation="horizontal"
    android:padding="16dp">

    <TextView
        android:id="@+id/tv_content"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="列表项内容"/>

    <ImageButton
        android:id="@+id/ib_action"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:focusable="false"
        android:focusableInTouchMode="false"
        android:src="@drawable/ic_action"/>
</LinearLayout>

二、分别实现ImageButton和Item的点击逻辑 #

1. 在CustomAdapter中处理ImageButton的点击 #

在getView方法里，给ImageButton设置点击监听器，注意要通过getTag()/setTag()绑定当前Item的position，避免复用混乱：

public class CustomAdapter extends ArrayAdapter<String> {
    private Context mContext;
    private List<String> mData;

    public CustomAdapter(Context context, List<String> data) {
        super(context, 0, data);
        mContext = context;
        mData = data;
    }

    @NonNull
    @Override
    public View getView(int position, @Nullable View convertView, @NonNull 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.ibAction = convertView.findViewById(R.id.ib_action);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        // 绑定数据
        holder.tvContent.setText(mData.get(position));

        // 给ImageButton设置点击事件，绑定position
        holder.ibAction.setTag(position);
        holder.ibAction.setOnClickListener(v -> {
            int pos = (int) v.getTag();
            // 这里处理ImageButton的点击逻辑，比如弹出提示或执行操作
            Toast.makeText(mContext, "点击了第" + (pos+1) + "项的按钮", Toast.LENGTH_SHORT).show();
        });

        return convertView;
    }

    static class ViewHolder {
        TextView tvContent;
        ImageButton ibAction;
    }
}

2. 实现ListView的单/多选点击逻辑 #

在Activity/Fragment中，给ListView设置onItemClickListener，同时根据需求设置选择模式：

情况1：单选模式

ListView listView = findViewById(R.id.list_view);
CustomAdapter adapter = new CustomAdapter(this, dataList);
listView.setAdapter(adapter);

// 设置单选模式
listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE);

listView.setOnItemClickListener((parent, view, position, id) -> {
    // 处理单选逻辑，比如获取选中项
    String selectedItem = dataList.get(position);
    Toast.makeText(this, "选中了：" + selectedItem, Toast.LENGTH_SHORT).show();
});

情况2：多选模式

需要维护一个集合记录选中的position，避免因Item复用导致状态混乱：

ListView listView = findViewById(R.id.list_view);
CustomAdapter adapter = new CustomAdapter(this, dataList);
listView.setAdapter(adapter);

// 设置多选模式
listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE);
// 自定义选中状态集合（如果需要自定义选中UI的话）
SparseBooleanArray selectedPositions = new SparseBooleanArray();

listView.setOnItemClickListener((parent, view, position, id) -> {
    // 更新选中状态
    if (selectedPositions.get(position)) {
        selectedPositions.delete(position);
        // 这里可以更新Item的选中UI，比如取消背景高亮
        view.setBackgroundColor(Color.TRANSPARENT);
    } else {
        selectedPositions.put(position, true);
        // 设置选中UI，比如背景高亮
        view.setBackgroundColor(Color.parseColor("#E0E0E0"));
    }

    // 处理多选后的逻辑，比如获取所有选中项
    List<String> selectedItems = new ArrayList<>();
    for (int i = 0; i < dataList.size(); i++) {
        if (selectedPositions.get(i)) {
            selectedItems.add(dataList.get(i));
        }
    }
    Toast.makeText(this, "选中了" + selectedItems.size() + "项", Toast.LENGTH_SHORT).show();
});

三、额外注意事项 #

• 如果你的Item里还有其他可点击控件（比如CheckBox、Button），同样需要给它们设置focusable="false"和focusableInTouchMode="false"，或者依赖根布局的blocksDescendants属性。
• 多选模式下，如果需要在适配器中更新选中UI，建议把selectedPositions集合传递给适配器，在getView方法中根据集合状态更新UI，这样能避免Item复用导致的状态错乱。

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