ListView单选Checkbox实现：勾选当前项并取消前一项选中状态

核心思路很简单：记录上一次选中的Checkbox实例，每次点击新的Checkbox时，先取消上一个的选中状态，再把当前Checkbox设为选中，同时更新记录的实例。还要注意ListView的item复用问题，得配合数据状态同步UI，避免滚动后状态混乱。

具体实现步骤 #

• 第一步：在你的Activity/Fragment里定义成员变量，保存上一个选中的Checkbox：

  private Checkbox lastCheckedCheckbox;
  

• 第二步：在自定义ListView Adapter的getView()方法中，给每个Checkbox设置点击监听器，并处理选中逻辑：

  @Override
  public View getView(int position, View convertView, ViewGroup parent) {
      ViewHolder holder;
      if (convertView == null) {
          convertView = LayoutInflater.from(mContext).inflate(R.layout.list_item_layout, parent, false);
          holder = new ViewHolder();
          holder.checkbox = convertView.findViewById(R.id.item_checkbox);
          convertView.setTag(holder);
      } else {
          holder = (ViewHolder) convertView.getTag();
      }
  
      // 先根据数据状态设置Checkbox选中状态（解决item复用导致的状态错乱）
      YourDataItem item = mDataList.get(position);
      holder.checkbox.setChecked(item.isChecked());
  
      // 设置点击监听
      holder.checkbox.setOnClickListener(v -> {
          Checkbox currentCheckbox = (Checkbox) v;
          if (currentCheckbox.isChecked()) {
              // 取消上一个选中项的状态
              if (lastCheckedCheckbox != null && lastCheckedCheckbox != currentCheckbox) {
                  lastCheckedCheckbox.setChecked(false);
                  // 同步更新上一项的数据状态
                  int lastPos = (int) lastCheckedCheckbox.getTag();
                  mDataList.get(lastPos).setChecked(false);
              }
              // 更新当前项的数据状态
              item.setChecked(true);
              // 记录当前选中的Checkbox
              lastCheckedCheckbox = currentCheckbox;
              // 给Checkbox绑定position，方便后续找到对应数据
              currentCheckbox.setTag(position);
          } else {
              // 取消当前选中时，清空记录
              item.setChecked(false);
              lastCheckedCheckbox = null;
          }
      });
  
      return convertView;
  }
  
  // ViewHolder内部类，优化列表性能
  static class ViewHolder {
      Checkbox checkbox;
  }
  

• 第三步：准备对应的数据实体类，用字段记录选中状态：

  public class YourDataItem {
      private boolean isChecked;
      // 你的其他业务字段...
  
      public boolean isChecked() {
          return isChecked;
      }
  
      public void setChecked(boolean checked) {
          isChecked = checked;
      }
  
      // 构造方法、其他字段的getter/setter...
  }
  

关键注意点 #

• 必须同步更新数据的选中状态，不能只修改UI，否则ListView滚动复用item时，选中状态会出现错误。
• 给Checkbox设置position标签，是为了快速定位到对应的数据项，确保数据和UI状态一致。
• 如果需要默认选中某一项，初始化时把对应数据的isChecked设为true，同时在Adapter中把lastCheckedCheckbox指向对应的Checkbox即可。

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