Fragment中RecyclerView的SearchView失效及返回按钮处理求助

一、修复SearchView无法过滤RecyclerView的问题 #

首先，这类问题大多出在Adapter的过滤逻辑缺失或者SearchView的监听未正确设置上，我给你一步步梳理：

1. 让Adapter实现Filterable接口并完善过滤逻辑 #

你的Adapter需要维护两个数据集：原始的全量数据，以及用于显示的过滤后数据。然后通过重写getFilter()方法实现过滤逻辑：

class YourAdapter(private val originalDataList: List<YourDataModel>) :
    RecyclerView.Adapter<YourAdapter.YourViewHolder>(), Filterable {

    // 用于RecyclerView显示的过滤后数据
    private var filteredDataList: List<YourDataModel> = originalDataList

    // ... 这里省略ViewHolder定义、onCreateViewHolder、getItemCount等基础方法

    override fun onBindViewHolder(holder: YourViewHolder, position: Int) {
        // 注意：这里要用filteredDataList而不是originalDataList
        val item = filteredDataList[position]
        // 绑定数据到UI
    }

    override fun getFilter(): Filter {
        return object : Filter() {
            override fun performFiltering(constraint: CharSequence?): FilterResults {
                val searchQuery = constraint?.toString()?.lowercase(Locale.getDefault()) ?: ""
                val results = FilterResults()

                // 根据搜索词过滤数据
                results.values = if (searchQuery.isEmpty()) {
                    // 搜索词为空时返回原始全量数据
                    originalDataList
                } else {
                    // 匹配你数据模型中的字段，比如匹配名称、描述等
                    originalDataList.filter { dataItem ->
                        dataItem.yourTargetField.lowercase(Locale.getDefault()).contains(searchQuery)
                    }
                }
                return results
            }

            @Suppress("UNCHECKED_CAST")
            override fun publishResults(constraint: CharSequence?, results: FilterResults?) {
                // 更新过滤后的数据并通知RecyclerView刷新
                filteredDataList = results?.values as List<YourDataModel>
                notifyDataSetChanged()
            }
        }
    }
}

2. 在Fragment中给SearchView设置查询监听 #

确保你已经在Fragment中调用了setHasOptionsMenu(true)，然后在onCreateOptionsMenu中绑定SearchView并添加监听：

override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
    super.onCreateOptionsMenu(menu, inflater)
    inflater.inflate(R.menu.your_search_menu, menu)

    val searchMenuItem = menu.findItem(R.id.action_search)
    val searchView = searchMenuItem.actionView as SearchView

    // 设置搜索提示
    searchView.queryHint = "输入关键词搜索"

    // 监听搜索文本变化和提交事件
    searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
        override fun onQueryTextSubmit(query: String?): Boolean {
            // 提交搜索时执行过滤
            yourAdapter.filter.filter(query)
            // 收起键盘（可选）
            searchView.clearFocus()
            return true
        }

        override fun onQueryTextChange(newText: String?): Boolean {
            // 实时过滤输入的文本
            yourAdapter.filter.filter(newText)
            return true
        }
    })
}

常见坑点排查 #

• 不要直接修改原始数据列表，必须区分originalDataList和filteredDataList
• 过滤时统一转为小写（或大写），避免大小写不匹配导致的无结果
• 确保Adapter初始化时传入的是完整的原始数据，而不是空列表或部分数据

二、实现返回按钮隐藏键盘+恢复Fragment标题 #

我们可以通过OnBackPressedCallback监听返回事件，结合SearchView的展开/收起状态来处理：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val originalTitle = "你的Fragment原始标题"

    // 监听返回按钮事件
    requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner, object : OnBackPressedCallback(true) {
        override fun handleOnBackPressed() {
            val searchMenuItem = menu.findItem(R.id.action_search)
            if (searchMenuItem?.isActionViewExpanded == true) {
                // 1. 收起SearchView
                searchMenuItem.collapseActionView()
                // 2. 隐藏软键盘
                val imm = requireContext().getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
                imm.hideSoftInputFromWindow(view.windowToken, 0)
                // 3. 恢复原始标题
                requireActivity().supportActionBar?.title = originalTitle
                // 4. 清空搜索内容，恢复列表显示原始数据
                yourAdapter.filter.filter("")
            } else {
                // 若SearchView未展开，执行正常返回逻辑
                isEnabled = false
                requireActivity().onBackPressed()
            }
        }
    })

    // 可选：监听SearchView的展开/收起，自动切换标题
    val searchMenuItem = menu.findItem(R.id.action_search)
    searchMenuItem.setOnActionExpandListener(object : MenuItem.OnActionExpandListener {
        override fun onMenuItemActionExpand(item: MenuItem): Boolean {
            // 展开SearchView时，将标题置空或改为搜索提示
            requireActivity().supportActionBar?.title = ""
            return true
        }

        override fun onMenuItemActionCollapse(item: MenuItem): Boolean {
            // 收起SearchView时恢复原始标题
            requireActivity().supportActionBar?.title = originalTitle
            // 同时隐藏键盘并恢复列表
            val imm = requireContext().getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow(view.windowToken, 0)
            yourAdapter.filter.filter("")
            return true
        }
    })
}

这样处理后，用户点击返回按钮时：

• 如果SearchView处于展开状态，会先收起它、隐藏键盘、恢复标题并重置列表
• 如果SearchView未展开，则正常返回上一级页面

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