Drag工作原理及与Pager、BottomSheet等可滚动Composable的交互解析

核心原理概述 #

Drag手势是Compose PointerInput手势系统的核心能力之一，通过pointerInput修饰符注册监听，核心逻辑是跟踪指针的位移变化：当指针移动超过设定的触摸阈值后，进入正式拖拽流程，依次触发onDragStart、onDrag、onDragEnd等回调。

1. Drag为何无法与Pager等可滚动组件协同触发？ #

LazyList、Pager、BottomSheet这类组件底层基于Modifier.scroll实现，同方向下默认存在手势优先级竞争：可滚动组件的滚动手势优先级高于普通Drag手势，当系统检测到同方向拖拽动作时，滚动手势会先抢占指针事件，导致普通Drag无法触发。

默认同方向下Scroll与Pager的交互表现（可通过参数调整，实现单独触发Drag、单独触发Scroll或两者同时生效）：

2. Drag如何检测阈值并触发？ #

Drag的触发分为两个关键阶段：

• 初始判定阶段：检测指针的初始移动位移，当位移超过**触摸斜率阈值（touchSlop）**时，才会正式进入拖拽状态，触发onDragStart。该阈值可通过detectDragGestures的touchSlop参数自定义，默认值由系统根据设备特性设定。
• 持续拖拽阶段：进入拖拽状态后，指针每一次的位移变化都会触发onDrag回调，直到指针抬起或被其他手势抢占。

3. 为什么调用PointerInputChange.consume()无效？ #

consume()的作用是标记当前指针事件已被处理，但它的生效有前提：必须在手势竞争阶段（系统尚未确定哪个手势胜出时）调用。如果系统已经将事件分配给了优先级更高的手势（比如可滚动组件的滚动手势），此时再调用consume()无法回溯抢占事件，自然无效。

4. onDragCancel何时触发？ #

以下场景会触发onDragCancel回调：

• 拖拽过程中，被优先级更高的手势抢占了指针事件（比如拖拽时触发了可滚动组件的滚动）；
• 拖拽过程中指针意外离开当前组件区域（比如手指滑出屏幕）；
• 系统中断手势处理（比如来电、系统弹窗等）。

5. 如何实现能在任意场景工作的自定义Drag手势？ #

可以通过以下几种方式实现适配性更强的自定义Drag手势：

• 调整手势优先级：在pointerInput中自定义手势的优先级，让Drag手势优先于滚动手势获取事件；
• 条件触发拖拽：在detectDragGestures的初始回调中，结合业务逻辑判断是否触发拖拽（比如仅当拖拽起点在卡片特定区域时响应）；
• 结合滚动状态判断：监听可滚动组件的状态（如LazyListState、PagerState），仅当滚动处于边界位置时触发Drag手势。

示例：条件触发Drag手势实现的列表卡片滑出效果

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