如何为自定义样式Android AppCompatSpinner添加可搜索选项

本方案完全保留原有AppCompatSpinner控件、自定义下拉样式、交互逻辑，不替换原有Spinner组件，仅通过最小代码改动实现可搜索能力。

核心改造点 #

• 给现有自定义适配器增加筛选能力，支持按条目名称模糊匹配
• 拦截Spinner默认的下拉弹窗展开动作，替换为顶部带搜索输入框的弹窗，弹窗内的下拉列表完全复用原有自定义适配器，保持和原来一致的展示效果
• 页面原有布局的位置、尺寸、文本样式不做任何大的调整

第一步：改造自定义下拉适配器支持筛选 #

原适配器直接操作全量数据集，筛选时会破坏原始列表数据，需要拆分原始数据与展示数据，实现Filterable接口支持动态过滤，改造后代码如下：

class CustomDropDownAdapter(
    private val context: Context,
    // 全量原始数据集，永远不被筛选操作修改
    private val originalData: List<Model>
) : BaseAdapter(), Filterable {
    // 筛选后当前要展示的数据集
    private var filteredData: List<Model> = originalData
    private val inflater: LayoutInflater = 
        context.getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater

    // getView逻辑和原实现完全一致，仅将数据源替换为filteredData
    override fun getView(position: Int, convertView: View?, parent: ViewGroup?): View {
        val view: View
        val vh: ItemHolder
        if (convertView == null) {
            view = inflater.inflate(R.layout.custom_spinner_item, parent, false)
            vh = ItemHolder(view)
            view?.tag = vh
        } else {
            view = convertView
            vh = view.tag as ItemHolder
        }
        vh.label.text = filteredData[position].name
        val id = context.resources.getIdentifier(
            filteredData[position].url, "drawable", context.packageName
        )
        vh.img.setBackgroundResource(id)
        return view
    }

    override fun getItem(position: Int): Model = filteredData[position]

    override fun getCount(): Int = filteredData.size

    override fun getItemId(position: Int): Long = position.toLong()

    // 内置模糊筛选逻辑
    override fun getFilter(): Filter {
        return object : Filter() {
            override fun performFiltering(constraint: CharSequence?): FilterResults {
                val results = FilterResults()
                results.values = when {
                    // 空输入时展示全量数据
                    constraint.isNullOrBlank() -> originalData
                    // 非空输入时按名称做不区分大小写的模糊匹配
                    else -> {
                        val keyword = constraint.toString().trim().lowercase()
                        originalData.filter { it.name.lowercase().contains(keyword) }
                    }
                }
                results.count = (results.values as List<Model>).size
                return results
            }

            override fun publishResults(constraint: CharSequence?, results: FilterResults?) {
                filteredData = results?.values as List<Model>
                notifyDataSetChanged()
            }
        }
    }

    private class ItemHolder(row: View?) {
        val label: TextView
        val img: ImageView

        init {
            label = row?.findViewById(R.id.text) as TextView
            img = row?.findViewById(R.id.img) as ImageView
        }
    }
}

第二步：拦截Spinner点击事件，替换为带搜索栏的下拉弹窗 #

在onViewCreated方法中保留原有Spinner的初始化逻辑，新增点击拦截逻辑，不修改Spinner本身的控件属性，仅在展开下拉时弹出自定义带搜索能力的弹窗，代码如下：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 原有页面逻辑完全保留
    view.findViewById<Button>(R.id.button_second).setOnClickListener {
        findNavController().navigate(R.id.action_SecondFragment_to_FirstFragment)
    }

    val spinner04 = view.findViewById<AppCompatSpinner>(R.id.spinner04)
    val modelList: List<Model> = readFromAsset()
    val customDropDownAdapter = CustomDropDownAdapter(requireContext(), modelList)
    spinner04.adapter = customDropDownAdapter

    // 新增逻辑：拦截Spinner默认下拉行为
    spinner04.setOnClickListener {
        // 加载带搜索框的弹窗布局
        val popupView = layoutInflater.inflate(R.layout.popup_spinner_search, null)
        val searchEdit = popupView.findViewById<EditText>(R.id.et_search)
        val dropdownList = popupView.findViewById<ListView>(R.id.lv_dropdown)
        dropdownList.adapter = customDropDownAdapter

        // 初始化PopupWindow，尺寸和位置和原生下拉保持一致
        val popupWindow = PopupWindow(
            popupView,
            spinner04.width,
            ViewGroup.LayoutParams.WRAP_CONTENT,
            true
        ).apply {
            elevation = 8.dpToPx().toFloat()
            setOutsideTouchable(true)
        }

        // 搜索框输入监听，实时触发列表过滤
        searchEdit.addTextChangedListener { editable ->
            customDropDownAdapter.filter.filter(editable.toString())
        }

        // 列表项点击逻辑，选中后同步给原Spinner，保留原有选中展示逻辑
        dropdownList.onItemClickListener = { _, _, position, _ ->
            spinner04.setSelection(position)
            popupWindow.dismiss()
        }

        // 弹窗位置对齐Spinner底部
        popupWindow.showAsDropDown(spinner04, 0, 4.dpToPx())
    }
}

// 简单的dp转px扩展函数
fun Int.dpToPx(): Int {
    return (this * requireContext().resources.displayMetrics.density).toInt()
}

第三步：新增极简弹窗布局 #

仅需要新增一个带搜索框、列表的弹窗布局，不修改原有fragment_second.xml的任何结构，新建popup_spinner_search.xml即可：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:background="@android:color/white">

    <EditText
        android:id="@+id/et_search"
        android:layout_width="match_parent"
        android:layout_height="48dp"
        android:hint="Pretraži..."
        android:paddingHorizontal="16dp"
        android:textSize="18sp"
        android:inputType="text" />

    <ListView
        android:id="@+id/lv_dropdown"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:divider="@null"
        android:dividerHeight="0dp" />
</LinearLayout>

方案优势 #

• 无侵入修改原有Spinner控件，所有原有属性、自定义选中展示样式、页面约束都完全保留
• 无反射调用系统隐藏API，全版本Android系统兼容
• 下拉列表完全复用原有自定义适配器，下拉项的图标、文本样式和改造前完全一致
• 搜索逻辑实时响应，空输入时自动恢复全量列表展示

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