在传统的Android View体系中，处理点击可以用setOnClickListener，处理拖拽则要重写onTouchEvent并自己计算坐标差值，代码分散且容易出错。Jetpack Compose把这套逻辑统一到了Gesture手势体系中，通过pointerInput修饰符配合不同的手势检测函数，就能以声明式的方式完成点击、长按、拖拽等交互。本文将带你深入理解Compose手势检测的实现原理，并给出可直接运行的代码示例。
一、pointerInput修饰符的工作原理
Compose中所有手势处理都离不开pointerInput这个修饰符。它的核心作用是开启一个协程作用域，把手势事件的消费逻辑挂载到组合树上。每当传入的key发生变化时，旧的协程会被取消，新的检测逻辑会重新启动，这一点和LaunchedEffect的行为非常相似。
pointerInput接收两个参数：第一个是key，用于控制协程的生命周期；第二个是suspend lambda，在里面调用官方提供的各种手势检测函数。注意这些检测函数都是挂起函数，它们内部会不断从事件流中读取指针信息，检测到目标手势后执行回调。
一个需要注意的细节是，pointerInput内部使用了PointerInputScope，这个作用域提供了当前组件的尺寸信息（size属性）和坐标转换能力，因此在手势回调中拿到的坐标都是相对于当前组件左上角的局部坐标，不需要再做额外换算。
二、实现点击、双击与长按检测
点击类手势通过detectTapGestures函数实现，它支持四种回调：onTap（单击）、onDoubleTap（双击）、onLongPress（长按）以及onPress（按下，带松开回调）。下面是一个完整的示例，展示如何在一个Box上同时处理这几种手势。
@Composable
fun TapGestureDemo() {
var statusText by remember { mutableStateOf("请点击屏幕") }
Box(
modifier = Modifier
.fillMaxSize()
.pointerInput(Unit) {
detectTapGestures(
onTap = { offset ->
// offset是点击位置相对于当前组件左上角的坐标
statusText = "单击：x=${offset.x}, y=${offset.y}"
},
onDoubleTap = { offset ->
statusText = "双击：x=${offset.x}, y=${offset.y}"
},
onLongPress = { offset ->
statusText = "长按：x=${offset.x}, y=${offset.y}"
},
onPress = {
// awaitRelease()可以等待手指抬起
tryAwaitRelease()
}
)
},
contentAlignment = Alignment.Center
) {
Text(text = statusText, fontSize = 20.sp)
}
}
这里的tryAwaitRelease用于等待手指释放，如果想在按下时先做视觉反馈、抬起时恢复，就可以在这个回调中配合状态变量实现。另外要注意，同时注册onDoubleTap会带来约300毫秒的延迟，因为系统需要等待第二次点击以确认是双击还是单击，对响应速度要求高的场景要权衡使用。
三、实现拖拽手势检测
拖拽检测使用detectDragGestures函数，它会在手指移动时不断回调onDrag，参数中的dragAmount是本次事件的位移增量而非绝对坐标。通过累积这些增量，可以实现组件跟随手指移动的效果。
@Composable
fun DragGestureDemo() {
var offsetX by remember { mutableStateOf(0f) }
var offsetY by remember { mutableStateOf(0f) }
Box(
modifier = Modifier
.offset { IntOffset(offsetX.roundToInt(), offsetY.roundToInt()) }
.size(100.dp)
.background(Color.Blue, CircleShape)
.pointerInput(Unit) {
detectDragGestures(
onDragStart = { offset ->
// 拖拽开始时的手指位置
},
onDrag = { change, dragAmount ->
change.consume()
offsetX += dragAmount.x
offsetY += dragAmount.y
},
onDragEnd = {
// 手指抬起，可在此做惯性动画
},
onDragCancel = {
// 拖拽被其他手势打断
}
)
}
)
}
代码中的change.consume()表示消费这次移动事件，防止事件继续向父组件传递，这在处理嵌套滚动冲突时尤为重要。如果只想检测单一方向的拖拽，Compose还提供了detectHorizontalDragGestures和detectVerticalDragGestures两个专用函数，内部会自动过滤掉另一个方向的位移，适合实现滑块、抽屉等组件。
除了拖拽整个组件，Compose还提供了更底层的detectDragGesturesAfterLongPress，它要求先长按才能开始拖拽，典型应用是列表的多选拖动排序场景。选择哪种检测函数，取决于交互设计对触发条件的要求。
四、手势冲突处理与方案选型建议
实际项目中经常会遇到手势冲突，比如一个可横向滑动的列表内部嵌套了可拖拽的卡片。Compose的事件分发遵循子组件优先的原则，子组件通过consume事件来阻止父组件响应。如果需要父子协作，则应该使用nestedScroll修饰符来协调嵌套滚动。
在选型上有一个简单原则：简单的可点击交互优先使用clickable修饰符，它自带涟漪效果和无障碍支持；只有需要双击、长按、自定义拖拽逻辑时才使用pointerInput。因为pointerInput绕过了默认的无障碍处理，如果使用它实现核心交互，记得手动添加semantics信息，保证无障碍服务的可用性。
最后提醒一点，pointerInput的key如果传入了频繁变化的值，手势协程会被反复取消重启，可能造成状态丢失。通常传Unit即可，只有在确实需要根据某个状态重置手势逻辑时才传入具体key。理解了这些机制，Compose的手势处理就能做到既灵活又稳定。