Android Java实现带EditText与复选选项的自定义下拉列表方法

别用原生Spinner改造，坑太多，不同厂商ROM兼容性差，还没法自由嵌入输入控件。直接用「点击触发锚点 + PopupWindow承载自定义下拉面板」的方案实现，定制自由度最高，性能稳定，所有系统版本表现一致。

整体结构拆分 #

整个控件拆成3个独立部分，逻辑解耦，后续改样式、加功能都很方便：

• 触发锚点：用TextView/LinearLayout实现，平时展示已选中的内容，点击后弹出下拉面板
• 下拉面板：独立XML布局，从上到下依次放置输入框、选项列表，可按需加确定/取消按钮
• 选项列表：用RecyclerView实现，每个条目带复选框和选项文本，支持长列表滚动

具体实现步骤 #

• 先编写布局文件
  • 下拉面板布局：根节点用垂直方向LinearLayout，高度设为wrap_content，可配置最大高度（比如300dp，避免选项太多占满整屏）；顶部放EditText，配置imeOptions="actionDone"让软键盘右下角显示完成按钮；下方放RecyclerView承载选项列表
  • 列表条目布局：根节点用水平方向LinearLayout，设置16dp左右的内边距，左侧放CheckBox，右侧放TextView展示选项文本
• 封装自定义控件
  继承LinearLayout编写自定义的多选下拉控件，构造方法里初始化触发视图（展示已选内容的TextView+右侧下拉箭头图标），初始化PopupWindow，把下拉面板布局加载后塞给PopupWindow，配置PopupWindow点击外部可关闭、背景加圆角阴影，开启软键盘适配。给触发视图加点击监听，点击时计算锚点位置弹出PopupWindow。
• 实现列表适配器
  编写RecyclerView.Adapter，维护两个数据集合：全量选项List<String> allOptions、已选中选项List<String> selectedOptions。注意不要在ViewHolder里存储CheckBox的选中状态，所有状态统一从selectedOptions取值，onBindViewHolder阶段根据当前选项是否在选中列表里设置CheckBox勾选状态，避免列表滚动复用导致状态错乱。给整个条目根布局加点击事件，点击时切换该选项在selectedOptions里的存在状态，刷新当前条目；同时把CheckBox设为不可点击、不可获取焦点，避免和条目点击事件冲突。
• 实现新增选项逻辑
  在自定义控件里拿到下拉面板的EditText，设置软键盘完成动作监听：用户点击完成按钮时，先对输入内容做非空、去重校验，校验通过就调用适配器的新增选项方法，把新选项插到列表最前面，调用notifyItemInserted(0)刷新列表，之后清空输入框、收起软键盘。

必踩坑点提前规避 #

不要尝试反射修改原生Spinner的下拉弹窗来加输入框，Android 10之后很多相关API被限制，小米、华为等定制ROM的Spinner实现和原生AOSP逻辑不一致，大概率出现兼容bug。

• PopupWindow默认不会适配软键盘，弹出前必须调用setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)，否则软键盘弹出后会盖住输入框
• 如果需要点击条目立刻更新锚点上的已选中文本，记得在适配器的条目点击回调里同步更新触发视图的显示内容
• 关闭PopupWindow的时候要主动收起软键盘，否则会出现弹窗关闭后软键盘还残留在屏幕上的问题
• 新添加的选项如果需要默认选中，直接把内容加到selectedOptions集合里即可，不需要额外刷新整个列表

核心代码参考 #

适配器新增选项方法 #

// 新增选项方法，内置非空、去重判断
public void addOption(String newOption) {
    String trimContent = newOption.trim();
    if (TextUtils.isEmpty(trimContent)) return;
    if (allOptions.contains(trimContent)) return;
    allOptions.add(0, trimContent);
    notifyItemInserted(0);
    // 新选项默认选中可打开下面这行
    // selectedOptions.add(trimContent);
    rvOptions.scrollToPosition(0);
}

PopupWindow初始化配置 #

private void initPopupWindow(View contentView) {
    popupWindow = new PopupWindow(contentView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT, true);
    popupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
    popupWindow.setOutsideTouchable(true);
    // 关键配置：适配软键盘弹出
    popupWindow.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
    popupWindow.setOnDismissListener(() -> {
        // 弹窗关闭时主动收起软键盘
        InputMethodManager imm = (InputMethodManager) getContext().getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.hideSoftInputFromWindow(getWindowToken(), 0);
    });
}

内容的提问来源于stack exchange，提问作者A.Z