Android Jetpack Compose中限制TextField回车键不换行并执行动作

场景1：单行输入框（无需换行） #

直接通过配置键盘选项和动作，禁用换行并绑定回车触发逻辑：

TextField(
    value = text,
    onValueChange = { text = it },
    label = { Text("输入内容") },
    // 指定回车键为"完成"动作
    keyboardOptions = KeyboardOptions(
        imeAction = ImeAction.Done
    ),
    // 绑定回车触发的自定义逻辑
    keyboardActions = KeyboardActions(
        onDone = {
            // 这里写你的目标动作，比如提交表单、执行搜索
            performYourTargetAction()
            // 可选：隐藏软键盘
            val imm = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow((LocalView.current as View).windowToken, 0)
        }
    ),
    // 强制单行，彻底禁止换行输入
    singleLine = true
)

场景2：多行输入框（需保留换行但回车触发动作） #

如果是多行输入框，但希望电脑键盘的回车键触发指定动作而非换行，通过事件拦截实现：

var text by remember { mutableStateOf("") }
val context = LocalContext.current

TextField(
    value = text,
    onValueChange = { text = it },
    label = { Text("多行输入") },
    maxLines = 5,
    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Send),
    keyboardActions = KeyboardActions(
        onSend = {
            performYourTargetAction()
            // 隐藏键盘
            val imm = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow((LocalView.current as View).windowToken, 0)
        }
    ),
    // 拦截物理键盘回车事件
    onKeyEvent = { event ->
        if (event.nativeKeyEvent.keyCode == KeyEvent.KEYCODE_ENTER && event.action == KeyEvent.ACTION_DOWN) {
            performYourTargetAction()
            // 返回true表示消费该事件，不执行默认换行
            true
        } else {
            false
        }
    }
)

关键提示 #

• singleLine = true会强制输入框为单行，从根源上禁止换行，适合登录、搜索这类场景。
• onKeyEvent能精准拦截模拟器电脑键盘的回车事件，避免默认换行行为。
• KeyboardActions配合imeAction主要处理软键盘的回车动作，同时兼容物理键盘触发逻辑。

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