Android Studio 如何在 ListView 的每个列表项中添加 Button 按钮

以下为安卓原生开发的实现步骤，全程使用最基础的写法，无需复杂前置知识：

1. 创建列表项布局文件 #

在res/layout文件夹下新建布局文件，命名为item_list_content.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">

    <!-- 左边显示列表项的文本内容，可自行替换为其他控件 -->
    <TextView
        android:id="@+id/tv_item_content"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:textSize="16sp"/>

    <!-- 右侧操作按钮，添加focusable=false避免抢占ListView本身的点击事件 -->
    <Button
        android:id="@+id/btn_item_action"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="操作"
        android:focusable="false"/>

</LinearLayout>

2. 编写自定义适配器 #

直接继承通用的BaseAdapter，代码已添加详细注释，可直接复制修改逻辑：

public class ListWithButtonAdapter extends BaseAdapter {
    // 存储列表要展示的数据
    private List<String> dataList;
    private Context context;

    // 构造方法，传入上下文和要显示的数据源
    public ListWithButtonAdapter(Context context, List<String> dataList) {
        this.context = context;
        this.dataList = dataList;
    }

    @Override
    public int getCount() {
        return 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 holder;
        // 布局复用，优化列表滑动性能
        if (convertView == null) {
            // 加载刚才写的列表项布局
            convertView = LayoutInflater.from(context).inflate(R.layout.item_list_content, parent, false);
            holder = new ViewHolder();
            holder.tvContent = convertView.findViewById(R.id.tv_item_content);
            holder.btnAction = convertView.findViewById(R.id.btn_item_action);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        // 给当前项的文本控件赋值
        String currentData = dataList.get(position);
        holder.tvContent.setText(currentData);

        // 给当前项的按钮设置点击事件
        holder.btnAction.setOnClickListener(v -> {
            // 此处写按钮点击后的业务逻辑，position即为当前点击的列表项序号
            Toast.makeText(context, "点击了第" + (position+1) + "项的按钮，对应内容：" + currentData, Toast.LENGTH_SHORT).show();
        });

        return convertView;
    }

    // 控件缓存类，避免重复执行findViewById
    static class ViewHolder {
        TextView tvContent;
        Button btnAction;
    }
}

3. 给ListView绑定适配器 #

在展示ListView的Activity/Fragment中直接调用即可：

// 1. 准备测试数据，可替换为自己的业务数据
List<String> testData = new ArrayList<>();
for (int i = 0; i < 20; i++) {
    testData.add("列表项" + (i+1));
}
// 2. 初始化适配器
ListWithButtonAdapter adapter = new ListWithButtonAdapter(this, testData);
// 3. 绑定ListView，此处id替换为你布局文件中ListView对应的id
ListView listView = findViewById(R.id.your_listview_id);
listView.setAdapter(adapter);

注意事项 #

• 如果不需要监听ListView本身的条目点击事件，可以省略Button的android:focusable="false"属性
• 如需展示更复杂的内容，可把数据源的String类型替换为自定义实体类，只需要修改Adapter中的赋值逻辑即可

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