Android Kotlin 外接物理键盘触发搜索框换行而非提交搜索问题

OutlinedTextField的singleLine和maxLines配置仅限制文本的显示样式，不会拦截物理键盘的回车输入事件。软键盘触发的是IME动作回调，而外接物理键盘的回车会被识别为普通按键输入，默认会往输入框插入换行符，就会出现光标下移但输入框不扩展的异常表现。

要同时兼容软键盘和物理键盘的搜索触发逻辑，需要额外做两处配置：

• 显式指定IME动作，配置软键盘搜索按钮的触发逻辑
• 新增物理键盘按键拦截逻辑，提前消费回车事件，避免插入换行

完整实现代码 #

import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.text.KeyboardActions
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.OutlinedTextField
import androidx.compose.material.Text
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.ExperimentalComposeUiApi
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.key.Key
import androidx.compose.ui.input.key.KeyEventType
import androidx.compose.ui.input.key.key
import androidx.compose.ui.input.key.onPreviewKeyEvent
import androidx.compose.ui.input.key.type
import androidx.compose.ui.platform.LocalSoftwareKeyboardController
import androidx.compose.ui.text.input.ImeAction

@OptIn(ExperimentalComposeUiApi::class)
@Composable
fun SearchTextField() {
    var searchContent by remember { mutableStateOf("") }
    val keyboardController = LocalSoftwareKeyboardController.current

    // 搜索逻辑抽成公共方法，避免两边重复写
    fun submitSearch() {
        if (searchContent.isBlank()) return
        // 这里替换为你自己的搜索请求逻辑
        // ...
        keyboardController?.hide()
    }

    OutlinedTextField(
        value = searchContent,
        onValueChange = { searchContent = it },
        label = { Text("请输入搜索内容") },
        singleLine = true,
        maxLines = 1,
        // 配置软键盘搜索动作
        keyboardOptions = KeyboardOptions(
            imeAction = ImeAction.Search
        ),
        keyboardActions = KeyboardActions(
            onSearch = { submitSearch() }
        ),
        modifier = Modifier
            .fillMaxWidth()
            // 拦截物理键盘回车事件
            .onPreviewKeyEvent { keyEvent ->
                if (keyEvent.type == KeyEventType.KeyUp && keyEvent.key == Key.Enter) {
                    submitSearch()
                    // 返回true表示事件已被消费，不会再传递给输入框插入换行
                    true
                } else {
                    false
                }
            }
    )
}

修改后物理键盘按下回车时，事件会被提前拦截处理，不会再触发换行逻辑，同时软键盘的搜索按钮功能保持正常。

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