MaterialAlertDialog单选/多选选项不显示问题排查与解决

问题场景 #

• 基于MaterialAlertDialogBuilder封装自定义DialogFragment实现代码复用
• 配置singleChoiceItems或multipleChoiceItems后，选项完全无法显示
• 已尝试方案：单独设置单选/多选、在普通Fragment中直接创建对话框、更换多个Material Design版本，均未解决问题
• 偶然发现：移除builder.setMessage(message)配置后，单选/多选选项可正常显示

原因分析 #

MaterialAlertDialog的默认布局逻辑存在限制：消息文本区域与单选/多选列表区域会抢占内容空间，当同时调用setMessage()和单选/多选选项设置方法时，消息区域会占据对话框的主要内容区域，导致列表被挤压隐藏。

解决办法 #

根据业务需求选择以下方案：

1. 移除setMessage()调用
   如果不需要同时展示消息文本和单选/多选列表，直接删除builder.setMessage(message)代码，即可让选项正常显示。

2. 自定义对话框布局（需同时展示消息和选项时）
   创建自定义布局文件，在布局中同时添加文本控件和单选/多选列表控件，通过builder.setView(customView)替代默认的消息和选项设置。示例代码片段：

   // 加载自定义布局
   View customView = LayoutInflater.from(requireContext()).inflate(R.layout.custom_dialog_layout, null);
   // 初始化布局控件
   TextView dialogMsg = customView.findViewById(R.id.tv_dialog_message);
   ListView choiceListView = customView.findViewById(R.id.lv_choice_list);
   
   dialogMsg.setText("需要展示的消息内容");
   // 设置单选列表示例
   ArrayAdapter<String> adapter = new ArrayAdapter<>(requireContext(), 
           android.R.layout.simple_list_item_single_choice, new String[]{"选项1", "选项2"});
   choiceListView.setAdapter(adapter);
   choiceListView.setChoiceMode(ListView.CHOICE_MODE_SINGLE);
   
   // 构建对话框
   new MaterialAlertDialogBuilder(requireContext())
           .setTitle("对话框标题")
           .setView(customView)
           .setPositiveButton("确定", (dialog, which) -> {
               // 处理确认逻辑
           })
           .show();
   

3. 单选场景可用setItems()替代
   若仅需单选功能，可尝试用setItems()替代singleChoiceItems，部分场景下该方法可与setMessage()共存，但需注意交互逻辑与单选列表的差异。

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