Compose桌面端开发中如何处理TextField编辑时的回车键事件？

问题根源 #

• 桌面端Compose的onKeyEvent修饰符默认会捕获三类按键事件：KeyDown（按键按下）、KeyUp（按键抬起）、Unknown（未知事件），未指定事件类型的情况下，单次按下回车会触发两次回调，长按回车还会持续触发KeyDown重复事件，因此会出现多次打印的问题
• KeyEvent.ACTION_UP是Android平台专属API，桌面端Compose使用KeyEventType枚举类判断事件类型，需要单独导入相关扩展

正确实现方案 #

依赖导入 #

首先导入必要的扩展属性：

import androidx.compose.ui.input.key.KeyEventType
import androidx.compose.ui.input.key.type
import androidx.compose.ui.input.key.isRepeat

方案1：回车抬起时触发（无重复，推荐） #

仅在用户松开回车键时触发逻辑，单次点击、长按都只会触发一次：

val requester = remember { FocusRequester() }
LaunchedEffect(Unit) {
    requester.requestFocus()
}
Text("   Play", textAlign = TextAlign.Center, fontSize = 30.sp)
val move = remember { mutableStateOf("Play") }
TextField(
    value = move.value,
    onValueChange = { move.value = it },
    label = { Text("Move") },
    maxLines = 1,
    textStyle = TextStyle(color = Color.Black, fontWeight = FontWeight.Bold),
    modifier = Modifier.padding(20.dp)
        .onKeyEvent {
            // 仅匹配回车抬起事件
            if (it.key == Key.Enter && it.type == KeyEventType.KeyUp) {
                println(move.value)
                // 后续可自行添加存入列表、清空输入等业务逻辑
                true
            } else {
                false
            }
        }
        .focusRequester(requester)
)

注意：TextField本身自带可聚焦属性，不需要额外添加focusable()修饰符，避免焦点逻辑冲突。

方案2：回车按下时触发（过滤重复事件） #

如果希望按下回车立刻触发、不需要等抬起，可过滤长按产生的重复事件：

.onKeyEvent {
    // 仅匹配第一次按下回车的事件，过滤长按重复事件
    if (it.key == Key.Enter && it.type == KeyEventType.KeyDown && !it.isRepeat) {
        println(move.value)
        true
    } else {
        false
    }
}

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