开头：为什么需要拖拽交互？

在移动应用开发中，列表项的拖拽排序是提升用户体验的关键功能之一。无论是任务管理应用的优先级调整，还是相册应用的图片排序，流畅的拖拽效果都能让用户直观地感知操作结果。但许多Android开发者面临以下问题：

• 如何在不引入复杂第三方库的情况下实现拖拽？
• ItemTouchHelper的工作原理是什么？
• 如何处理拖拽过程中的数据同步？

本文将使用Kotlin语言，通过分步骤实现+原理剖析的方式，带你掌握从基础实现到高级定制的完整流程。

中间讨论：实现原理与核心代码

1. 基础实现：ItemTouchHelper的核心作用

// 第一步：创建ItemTouchHelper.Callback
class DragCallback(
    private val adapter: ItemAdapter
) : ItemTouchHelper.Callback() {

    override fun getMovementFlags(
        recyclerView: RecyclerView,
        viewHolder: RecyclerView.ViewHolder
    ): Int {
        // 允许上下拖拽，禁止左右滑动
        val dragFlags = ItemTouchHelper.UP or ItemTouchHelper.DOWN
        return makeMovementFlags(dragFlags, 0)
    }

    override fun onMove(
        recyclerView: RecyclerView,
        viewHolder: RecyclerView.ViewHolder,
        target: RecyclerView.ViewHolder
    ): Boolean {
        // 交换数据源位置
        val from = viewHolder.adapterPosition
        val to = target.adapterPosition
        Collections.swap(adapter.items, from, to)
        adapter.notifyItemMoved(from, to)
        return true
    }

    override fun onSwiped(viewHolder: RecyclerView.ViewHolder, direction: Int) {
        // 禁用滑动操作
    }
}

// 绑定到RecyclerView
val itemTouchHelper = ItemTouchHelper(DragCallback(adapter))
itemTouchHelper.attachToRecyclerView(recyclerView)

关键点解析：

• getMovementFlags() 定义支持的交互方向
• onMove() 是拖拽时的核心回调
• 必须调用adapter.notifyItemMoved()保持数据同步

2. 高级定制：拖拽视觉反馈

override fun onSelectedChanged(
    viewHolder: RecyclerView.ViewHolder?, 
    actionState: Int
) {
    super.onSelectedChanged(viewHolder, actionState)
    when (actionState) {
        ItemTouchHelper.ACTION_STATE_DRAG -> {
            // 拖拽开始时添加高亮效果
            viewHolder?.itemView.alpha = 0.7f
            viewHolder?.itemView.setBackgroundColor(
                Color.LTGRAY
            )
        }
    }
}

override fun clearView(
    recyclerView: RecyclerView, 
    viewHolder: RecyclerView.ViewHolder
) {
    super.clearView(recyclerView, viewHolder)
    // 拖拽结束后恢复样式
    viewHolder.itemView.alpha = 1.0f
    viewHolder.itemView.setBackgroundColor(
        Color.WHITE
    )
}

3. 边界处理：自动滚动优化

override fun onMove(...) {
    // 添加边界检测
    val maxPosition = adapter.itemCount - 1
    val adjustedTo = to.coerceIn(0, maxPosition)
    
    // 触发自动滚动
    if (adjustedTo == maxPosition) {
        recyclerView.smoothScrollBy(0, 100)
    }
}

结尾：最佳实践建议

1. 性能优化：

   • 使用DiffUtil代替notifyDataSetChanged()
   • 避免在onMove()中执行耗时操作

2. 用户体验：

   • 添加震动反馈：performHapticFeedback(HapticFeedbackConstants.LONG_PRESS)
   • 使用Elevation提升拖拽项的层级感

3. 扩展方向：

   • 实现跨RecyclerView的拖拽
   • 结合ViewGroup实现多列表看板

// 进阶：实现拖拽手柄触发
itemView.findViewById<View>(R.id.drag_handle).setOnTouchListener { v, event ->
    if (event.action == MotionEvent.ACTION_DOWN) {
        itemTouchHelper.startDrag(viewHolder)
    }
    false
}