简介本资源是一份面向Android初中级开发者的自定义多选对话框实战示例聚焦DialogListViewCheckBox组合实现解决应用中常见的批量选项交互需求如联系人选择、权限配置或设置项勾选等场景。压缩包共966个文件约8.71MB包含115个.dex可执行字节码、113个.class类文件、116个.json配置与数据样本、17个.java源码含MyDialog、MyListAdapter等核心类、17个.xml布局文件如dialog_layout、list_item及16个.png图标资源结构完整覆盖UI定义、适配器逻辑、全选/反选状态管理与按钮回调处理。已有940人学习下载资源提供可直接运行的调试APK、完整项目工程含gradle构建配置与iml元数据以及清晰分层的源码组织便于理解Dialog生命周期控制、ListView动态刷新机制与CheckBox状态同步原理是掌握Android原生组件协同开发的优质实践素材。1. Android自定义Dialog多选对话框不是套个ListView就完事漏掉这三步交互逻辑直接翻车你是不是也试过用AlertDialog.Builder套个ListView加CheckBox以为“多选对话框”就搞定了结果一跑起来发现勾选状态不保存、点击空白区域 Dialog 消失但 CheckBox 状态丢了、返回键再点开列表又回到初始状态……这不是 Bug是没理解 Android Dialog 的生命周期和 View 复用机制。这个资源包提供的是一个可复用、状态持久、支持全选/反选/禁用项、适配 Android 5.0 Material 主题的完整实现核心不是“怎么画个框”而是“怎么让多选行为真正受控”。它适合正在做设置页、权限批量操作、筛选条件配置的 Android 开发者——尤其当你被产品提了“上次选的要默认勾上”这种需求时别再手写一堆SparseBooleanArray和onDismissListener了。包里包含带注释的 Java 源码、布局 XML、自定义 Adapter 和一份实测通过的调用示例所有代码基于androidx.appcompat.app.AlertDialog构建不依赖任何第三方 UI 库。2. 为什么必须自定义原生 AlertDialog 的三个硬伤与选型依据2.1 原生多选 Dialog 的三大不可解缺陷Android SDK 提供的setItems()和setMultiChoiceItems()确实能快速弹出多选项但它们在真实业务中几乎无法落地状态不可控setMultiChoiceItems()内部使用CheckedTextView其checked状态由 Dialog 自己维护你无法在外部读取或预设一旦用户点击确认按钮SDK 只回调一个boolean[]数组但这个数组索引和你原始数据源的顺序强绑定稍有增删改就错位UI 定制断层你想加个图标、换字体颜色、支持禁用某几项原生 API 不暴露Adapter你连getView()都重写不了生命周期脱钩Dialog 关闭后所有 View 被销毁CheckBox 状态彻底丢失下次再弹除非你手动存SharedPreferences并在onPrepareDialog()里恢复否则就是“白忙活”。提示很多教程教你在onClick()里遍历ListView的getChildAt()获取 CheckBox 状态——这是典型玄学写法。ListView复用convertViewgetChildAt(i)返回的 View 可能根本不是第 i 条数据对应的 View尤其当列表滚动后必翻车。2.2 为什么选 Dialog ListView CheckBox 而非 RecyclerView虽然RecyclerView是现代首选但本方案坚持用ListView有明确工程考量兼容性兜底项目需最低支持 Android 4.1API 16而RecyclerView在低版本存在notifyDataSetChanged()后CheckBox状态错乱的已知问题见 AOSP Issue #78231轻量级交互确定性多选对话框通常条目数 20ListView的View复用策略比RecyclerView更简单状态管理逻辑更透明避免嵌套滚动冲突AlertDialog内部ScrollView与RecyclerView的嵌套滚动处理复杂ListView作为原生子 View 兼容性更好。我们不是拒绝新东西而是把“稳定交付”放在“技术先进”前面。如果你的项目已全面迁移到androidx.recyclerview:recyclerview且最低 API ≥ 21文末进阶章节会给出等效RecyclerView改造方案。2.3 核心设计原则状态分离 生命周期感知本方案将多选状态完全从 UI 层剥离采用三层结构层级职责实现载体数据层存储原始选项、是否启用、是否默认选中ListDialogItem其中DialogItem含text,enabled,checked字段状态层管理当前选中状态、全选/反选逻辑、禁用项过滤MultiSelectDialogState类封装SparseBooleanArray 业务规则视图层渲染列表、响应点击、同步状态变更自定义MultiSelectListAdapterDialog的setView()关键点在于Dialog本身不持有状态所有状态变更都通过state对象触发Adapter只负责“读取状态并渲染”不负责“修改状态”。这样即使 Dialog 销毁重建只要state对象存活例如作为 Activity 成员变量状态就能无缝延续。3. 源码结构解析从布局到 Adapter 的四层拆解3.1 布局文件dialog_multiselect.xml精简但不可省略的容器!-- res/layout/dialog_multiselect.xml -- LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationvertical android:padding16dp TextView android:idid/tv_title android:layout_widthmatch_parent android:layout_heightwrap_content android:textSize16sp android:textStylebold android:layout_marginBottom12dp / ListView android:idid/lv_items android:layout_widthmatch_parent android:layout_height0dp android:layout_weight1 android:dividerandroid:color/darker_gray android:dividerHeight0.5dp android:scrollbarsnone / LinearLayout android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationhorizontal android:layout_marginTop16dp Button android:idid/btn_select_all android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:text全选 android:textSize14sp / Button android:idid/btn_inverse android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:text反选 android:textSize14sp / Button android:idid/btn_cancel android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:text取消 android:textSize14sp / /LinearLayout /LinearLayout注意ListView的layout_weight1是关键。AlertDialog默认内容区高度固定若不设权重列表可能被截断android:scrollbarsnone是为了视觉统一实际滚动仍可用。Button区域独立于ListView避免ListView的clickabletrue干扰按钮事件。3.2 数据模型DialogItem.java支持禁用与默认状态// src/main/java/com/example/dialog/DialogItem.java public class DialogItem { public final String text; public final boolean enabled; // 是否可交互 public boolean checked; // 当前是否选中注意非 final需可变 public DialogItem(String text) { this(text, true, false); } public DialogItem(String text, boolean enabled, boolean checked) { this.text text; this.enabled enabled; this.checked checked; } }逻辑说明enabled控制 CheckBox 是否可点击setChecked()仍生效但setOnClickListener会被忽略checked是运行时状态初始化时由调用方决定。不要用Boolean包装类——避免空指针且SparseBooleanArray依赖原始boolean。3.3 状态管理器MultiSelectDialogState.java全选/反选的核心算法// src/main/java/com/example/dialog/MultiSelectDialogState.java public class MultiSelectDialogState { private final SparseBooleanArray checkedStates; private final ListDialogItem items; public MultiSelectDialogState(ListDialogItem items) { this.items items; this.checkedStates new SparseBooleanArray(items.size()); // 初始化按 DialogItem.checked 设置初始状态 for (int i 0; i items.size(); i) { checkedStates.put(i, items.get(i).checked); } } // 全选仅对 enabled true 的项生效 public void selectAll() { for (int i 0; i items.size(); i) { if (items.get(i).enabled) { checkedStates.put(i, true); } } } // 反选enabled 项才参与反选disabled 项保持原 checked 状态 public void inverseSelection() { for (int i 0; i items.size(); i) { if (items.get(i).enabled) { checkedStates.put(i, !checkedStates.get(i, false)); } } } // 获取当前选中项的索引列表用于回调 public ListInteger getSelectedIndices() { ListInteger indices new ArrayList(); for (int i 0; i items.size(); i) { if (checkedStates.get(i, false)) { indices.add(i); } } return indices; } // 同步状态回 DialogItem调用方需在 dismiss 前执行 public void syncToItems() { for (int i 0; i items.size(); i) { items.get(i).checked checkedStates.get(i, false); } } }参数说明syncToItems()是关键收口。它必须在 Dialog 关闭前如btn_confirm.setOnClickListener内调用否则DialogItem中的checked字段不会更新下次弹窗仍是旧状态。这是状态“持久化”的最后一环。3.4 自定义 AdapterMultiSelectListAdapter.java复用安全的渲染逻辑// src/main/java/com/example/dialog/MultiSelectListAdapter.java public class MultiSelectListAdapter extends BaseAdapter { private final ListDialogItem items; private final MultiSelectDialogState state; private final LayoutInflater inflater; public MultiSelectListAdapter(Context context, ListDialogItem items, MultiSelectDialogState state) { this.items items; this.state state; this.inflater LayoutInflater.from(context); } Override public int getCount() { return items.size(); } Override public Object getItem(int position) { return items.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 inflater.inflate(R.layout.item_multiselect, parent, false); holder new ViewHolder(); holder.textView convertView.findViewById(R.id.tv_text); holder.checkBox convertView.findViewById(R.id.cb_check); convertView.setTag(holder); } else { holder (ViewHolder) convertView.getTag(); } DialogItem item items.get(position); holder.textView.setText(item.text); holder.checkBox.setChecked(state.checkedStates.get(position, false)); holder.checkBox.setEnabled(item.enabled); // 关键CheckBox 点击不直接改 state而是通过 setOnCheckedChangeListener // 避免复用时监听器错位 holder.checkBox.setOnCheckedChangeListener(null); // 先清空旧监听 holder.checkBox.setOnCheckedChangeListener((buttonView, isChecked) - { if (item.enabled) { // 仅 enabled 项才响应 state.checkedStates.put(position, isChecked); } }); return convertView; } static class ViewHolder { TextView textView; CheckBox checkBox; } }逻辑说明setOnCheckedChangeListener(null)是血泪经验。ListView复用convertView时旧CheckBox的监听器还在若不清空一次点击可能触发多个监听器导致状态错乱。holder.checkBox.setEnabled(item.enabled)控制视觉灰度和点击穿透比setClickable(false)更符合 Material 设计规范。4. 集成与调用三步接入附带 Kotlin 与 Java 双版本示例4.1 Step 1准备数据源与状态对象Activity/Fragment 中// Java 版Activity 中 private ListDialogItem dialogItems; private MultiSelectDialogState dialogState; private void initDialogData() { dialogItems new ArrayList(); dialogItems.add(new DialogItem(选项一, true, true)); // 默认选中 dialogItems.add(new DialogItem(选项二, true, false)); dialogItems.add(new DialogItem(选项三, false, false)); // 禁用项 dialogItems.add(new DialogItem(选项四, true, true)); dialogState new MultiSelectDialogState(dialogItems); }// Kotlin 版Fragment 中 private var dialogItems: ListDialogItem emptyList() private lateinit var dialogState: MultiSelectDialogState private fun initDialogData() { dialogItems listOf( DialogItem(选项一, enabled true, checked true), DialogItem(选项二, enabled true, checked false), DialogItem(选项三, enabled false, checked false), // 禁用 DialogItem(选项四, enabled true, checked true) ) dialogState MultiSelectDialogState(dialogItems.toMutableList()) }注意dialogState必须是成员变量不能在showDialog()方法内局部创建否则每次弹窗都是新状态无法延续上次选择。4.2 Step 2构建 Dialog 并设置 View核心集成点// Java 版 private void showDialog() { AlertDialog.Builder builder new AlertDialog.Builder(this); View dialogView getLayoutInflater().inflate(R.layout.dialog_multiselect, null); // 绑定标题 TextView tvTitle dialogView.findViewById(R.id.tv_title); tvTitle.setText(请选择操作项); // 绑定 ListView ListView lvItems dialogView.findViewById(R.id.lv_items); MultiSelectListAdapter adapter new MultiSelectListAdapter(this, dialogItems, dialogState); lvItems.setAdapter(adapter); // 绑定底部按钮 Button btnSelectAll dialogView.findViewById(R.id.btn_select_all); btnSelectAll.setOnClickListener(v - dialogState.selectAll()); Button btnInverse dialogView.findViewById(R.id.btn_inverse); btnInverse.setOnClickListener(v - dialogState.inverseSelection()); Button btnCancel dialogView.findViewById(R.id.btn_cancel); btnCancel.setOnClickListener(v - dialog.dismiss()); // 关键设置自定义 View 到 Dialog builder.setView(dialogView); AlertDialog dialog builder.create(); // Dialog 关闭前同步状态重要 dialog.setOnDismissListener(d - dialogState.syncToItems()); dialog.show(); }// Kotlin 版 private fun showDialog() { val builder AlertDialog.Builder(requireContext()) val dialogView layoutInflater.inflate(R.layout.dialog_multiselect, null) dialogView.findViewByIdTextView(R.id.tv_title).text 请选择操作项 val lvItems dialogView.findViewByIdListView(R.id.lv_items) val adapter MultiSelectListAdapter(requireContext(), dialogItems, dialogState) lvItems.adapter adapter dialogView.findViewByIdButton(R.id.btn_select_all).setOnClickListener { dialogState.selectAll() } dialogView.findViewByIdButton(R.id.btn_inverse).setOnClickListener { dialogState.inverseSelection() } dialogView.findViewByIdButton(R.id.btn_cancel).setOnClickListener { dialog?.dismiss() } builder.setView(dialogView) val dialog builder.create() dialog.setOnDismissListener { dialogState.syncToItems() } dialog.show() }逻辑说明setOnDismissListener是状态落地的最后保险。无论用户点取消、点空白区域、按返回键都会触发syncToItems()确保dialogItems中的checked字段被更新。这是“状态持久”的技术锚点。4.3 Step 3获取选中结果确认按钮逻辑原方案未内置确认按钮因业务差异大有的要跳转有的要刷新列表。你只需在dialogView中添加一个Button并在其OnClickListener中// Java - 获取选中项索引 ListInteger selectedIndices dialogState.getSelectedIndices(); for (int index : selectedIndices) { String selectedText dialogItems.get(index).text; Log.d(MultiSelect, 选中: selectedText); } // 同步状态到数据源如果 dialogItems 是全局数据 dialogState.syncToItems();// Kotlin - 获取选中文本列表 val selectedItems dialogState.getSelectedIndices() .map { dialogItems[it].text } Log.d(MultiSelect, 选中项: $selectedItems) dialogState.syncToItems()提示getSelectedIndices()返回的是DialogItem在dialogItems列表中的索引不是ListView的position二者在此方案中一致但概念要分清。若需返回文本列表用map最安全。5. 避坑指南五个真实踩过的坑与根治方案5.1 现象CheckBox 点击无反应或点一次变两次原因ListView复用convertView时旧CheckBox的OnCheckedChangeListener未清除导致新CheckBox绑定监听器后旧监听器仍在内存中一次点击触发多次回调。解决在getView()中holder.checkBox.setOnCheckedChangeListener(null)必须放在setOnCheckedChangeListener之前强制解绑旧监听器。这是BaseAdapter复用机制的硬性要求不是可选项。5.2 现象Dialog 关闭后再次打开CheckBox 状态回到初始值原因dialogState对象生命周期错误。若在showDialog()方法内新建MultiSelectDialogState则每次弹窗都是全新状态与上次无关。解决dialogState必须声明为 Activity/Fragment 的成员变量并在onCreate()或onViewCreated()中初始化。确保整个组件生命周期内唯一。5.3 现象禁用项enabledfalse的 CheckBox 仍可点击原因只设置了checkBox.setEnabled(false)但未拦截CheckBox的clickable属性。Android 中setEnabled(false)仅影响视觉和onClickonCheckChanged仍会触发。解决在getView()中对禁用项额外设置holder.checkBox.setClickable(false)并确保setOnCheckedChangeListener内部有if (item.enabled)判断。5.4 现象列表滚动后CheckBox 状态错乱A 行勾选滚下去再滚回来变成 B 行勾选原因getView()中未根据position从state读取最新状态而是依赖convertView的旧状态。CheckBox复用时setChecked()未被调用。解决holder.checkBox.setChecked(state.checkedStates.get(position, false))这行代码必须存在且不能被if (convertView null)包裹——它要在每次getView()都执行。5.5 现象全选/反选按钮点击后ListView 无刷新CheckBox 状态未更新原因selectAll()和inverseSelection()只修改了SparseBooleanArray但ListView不知道数据变了未触发notifyDataSetChanged()。解决在按钮点击后必须显式调用adapter.notifyDataSetChanged()。本方案中MultiSelectListAdapter未暴露该方法因此需在showDialog()中保存adapter引用并在按钮点击后调用btnSelectAll.setOnClickListener(v - { dialogState.selectAll(); adapter.notifyDataSetChanged(); // 补上这一行 });注意notifyDataSetChanged()是ListView刷新的唯一可靠方式invalidateViews()或refreshDrawableState()均无效。6. 进阶技巧Material 主题适配、无障碍支持与 RecyclerView 迁移路径6.1 Material 主题下的视觉微调适配 Android 5.0原生AlertDialog在Theme.MaterialComponents下默认有圆角阴影但自定义 View 会丢失这些样式。需在dialog_multiselect.xml根布局添加LinearLayout ... android:background?attr/dialogCornerRadius !-- 继承主题圆角 -- android:elevation6dp !-- 添加阴影 --同时在showDialog()中为AlertDialog.Builder显式指定主题AlertDialog.Builder builder new AlertDialog.Builder(this, R.style.ThemeOverlay_MaterialComponents_Dialog);提示R.style.ThemeOverlay_MaterialComponents_Dialog是官方推荐的主题叠加层它保留 Dialog 基础样式如背景、边距只覆盖颜色和圆角避免全盘重写。6.2 无障碍支持TalkBack 兼容性补丁对于视障用户CheckBox需要明确的contentDescription。在getView()中补充String desc item.text (item.enabled ? 可选中 : 不可选中); holder.checkBox.setContentDescription(desc);同时为ListView添加android:importantForAccessibilityyes确保 TalkBack 能正确朗读列表项数量。6.3 RecyclerView 迁移对照表从 ListView 到 RecyclerView 的关键映射若你的项目已全面使用androidx.recyclerview:recyclerview以下是等效改造要点无需重写业务逻辑ListView 组件RecyclerView 等效方案注意事项BaseAdapterRecyclerView.AdapterViewHolderonBindViewHolder()中同样需setChecked()setOnCheckedChangeListener(null)getView()onBindViewHolder()holder.itemView.setEnabled(item.enabled)控制整行禁用notifyDataSetChanged()adapter.notifyDataSetChanged()行为一致但RecyclerView支持更细粒度刷新如notifyItemChanged()ListView的choiceMode无需设置由CheckBox状态控制RecyclerView无内置多选模式状态完全由state管理android:divider在item_multiselect.xml中用View作为分割线RecyclerView不支持android:divider需在 item 布局末尾加View android:layout_height0.5dp ... /从那以后我每次做 Dialog 多选需求都先检查三点state是否成员变量、setOnCheckedChangeListener(null)是否写了、syncToItems()是否在onDismiss里调用。这三步走完90% 的状态丢失问题就消失了。希望帮到你。本文还有配套的精品资源点击获取