Jetpack Compose 中实现长按拖拽排序

Wed, 20 May 2026 00:00:00 +0800
可复用提示词

请在现有 Android Jetpack Compose 列表页面中实现“长按拖拽排序”能力，要求尽量复用当前页面、ViewModel 和保存接口，不引入不必要的新库。

交互要求：
1. 用户长按列表行后进入拖动状态，整行跟随手指移动。
2. 长按生效时需要有明确反馈，例如背景高亮、轻微缩放、透明度变化或触觉反馈。
3. 拖动过程中展示一条高亮插入线，表示松手后条目会插入的位置。
4. 拖动过程中，被拖动条目跨过的其他行要动态让位。例如向下拖时，中间行上移；向上拖时，中间行下移。
5. 普通行间分隔线需要跟随对应行一起移动，插入线替换对应位置的分隔线，不要出现分隔线丢失或覆盖文字。
6. 松手后再真正修改数据顺序，不要在拖动过程中反复重排真实列表。
7. 当列表超过一屏时，拖动到列表顶部或底部附近需要自动滚动，让用户可以跨屏幕拖动条目。
8. 被挤压行移动时，行内容、行间分隔线、行间空白要作为一个完整视觉单元移动，不要把外边距或分隔线残留在原地。
9. 最终顺序应能通过现有保存流程持久化。

实现约束：
1. 使用 detectDragGesturesAfterLongPress 监听长按拖动。
2. 使用稳定 key 保持行身份，避免滚动或重排后移动到错误条目。
3. pointerInput 尽量保持稳定；如果回调依赖最新 index 或状态，用 rememberUpdatedState 转接最新回调。
4. 拖动开始时记录起始 index、起始手指 Y 坐标，并冻结一份当前可见行的真实屏幕坐标，拖动过程中用冻结坐标计算插入位置，避免视觉位移反过来影响命中判断导致抖动。
5. 插入位置使用 insertionIndex 表示，范围为 0..items.size；松手时把 fromIndex 转换成实际 targetIndex。
6. 用 onGloballyPositioned / positionInWindow 记录每一行 top、bottom，用 onSizeChanged 或兜底 dp 值记录行高。
7. 对被挤压的行使用 graphicsLayer.translationY 做视觉位移，不在拖动中修改真实列表顺序。
8. 行位移步长不要只用行内容高度，优先用相邻两行 top 坐标差，确保步长包含行间分隔线和行间空白。
9. LazyColumn 使用 rememberLazyListState，并记录列表 viewport 的 top、bottom；拖动时如果手指靠近 viewport 顶部或底部，使用 scrollBy 持续自动滚动。
10. 自动滚动会改变内容相对屏幕的位置，需要维护 dragScrollOffset：被拖动行的 translationY 要补上滚动消耗，命中插入位置时则用 fingerY = dragStartFingerY + dragOffset - dragScrollOffset，并让冻结坐标按 scrollOffset 修正。
11. 完成后运行 Kotlin/Gradle 编译检查，并说明验证结果。

请先阅读现有代码结构，再按项目已有风格实现。保持改动聚焦，避免重构无关逻辑。
Android on ARLOOR

Jetpack Compose 中实现长按拖拽排序

可复用提示词
