Android：SearchView为空时按下回车键如何收起软键盘？

这个场景我之前也踩过坑，默认的SearchView确实有这么个小限制——只有输入框里有内容时，按下回车键才会触发onQueryTextSubmit，空内容时完全没反应。不过我们可以通过直接监听键盘按键事件来绕过这个逻辑，实现不管有没有输入内容，按回车都能收起软键盘的需求。

具体实现方案 #

我们可以给SearchView额外添加一个OnKeyListener，直接捕获回车键的点击事件，然后执行收起键盘的操作，同时保留你原来的OnQueryTextListener逻辑（处理有内容时的提交需求）：

// 保留原有查询提交逻辑（处理有内容时的场景）
country_search.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
    override fun onQueryTextSubmit(query: String?): Boolean {
        country_search.clearFocus()
        // 这里可以添加有内容时的额外处理逻辑，比如发起搜索请求
        return true
    }

    override fun onQueryTextChange(newText: String?): Boolean {
        // 你的文本变化监听逻辑（如果有的话）
        return true
    }
})

// 添加按键监听，处理空内容时的回车事件
country_search.setOnKeyListener { _, keyCode, event ->
    // 仅响应回车键的按下动作，避免重复触发
    if (keyCode == KeyEvent.KEYCODE_ENTER && event.action == KeyEvent.ACTION_DOWN) {
        country_search.clearFocus()
        return@setOnKeyListener true // 消费该事件，阻止后续传递
    }
    false // 其他按键事件不处理
}

原理说明 #

• OnKeyListener会直接捕获SearchView上的所有按键事件，不受其默认的“空内容不触发提交”逻辑限制；
• 我们通过keyCode == KeyEvent.KEYCODE_ENTER和event.action == KeyEvent.ACTION_DOWN的判断，确保只响应回车键的按下动作，避免重复处理；
• 返回true表示我们已经处理了该事件，不需要再传递给系统的默认逻辑。

这样设置后，不管SearchView输入框里有没有内容，用户按下回车键都会触发clearFocus()，软键盘就会顺利收起啦～

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