Kotlin中如何为RecyclerView设置onItemTouchListener

Kotlin 完全兼容 Android 原生 RecyclerView 所有公开 API，Java 阶段使用的 addOnItemTouchListener 方法可直接在 Kotlin 中调用，不存在功能层面的差异。触摸事件绑定失败通常由事件拦截返回值配置错误、监听器挂载时机不对导致。

方式1：和 Java 逻辑完全一致的全局触摸监听（直接在 Activity 中实现） #

该写法和 Java 实现逻辑完全对齐，直接给 RecyclerView 挂载触摸监听器即可，不需要额外依赖：

// 在Activity的onCreate方法中，确保RecyclerView已经完成布局管理器、适配器绑定后调用
recyclerView.addOnItemTouchListener(object : RecyclerView.OnItemTouchListener {
    override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
        // 获取当前触摸坐标下对应的item子View
        val childView = rv.findChildViewUnder(e.x, e.y)
        if (childView != null) {
            // 编写对应触摸动作的处理逻辑
            when (e.action) {
                MotionEvent.ACTION_DOWN -> { /* 手指按下逻辑 */ }
                MotionEvent.ACTION_MOVE -> { /* 手指移动逻辑 */ }
                MotionEvent.ACTION_UP -> { /* 手指抬起逻辑 */ }
            }
        }
        // *非拦截场景不要返回true*，否则会抢占列表本身的滚动、子View点击事件，导致列表无法正常滑动
        return false
    }

    override fun onTouchEvent(rv: RecyclerView, e: MotionEvent) {
        // 仅当onInterceptTouchEvent返回true时，后续触摸事件序列才会走到该回调
    }

    override fun onRequestDisallowInterceptTouchEvent(disallowIntercept: Boolean) {
        // 处理子View请求父容器不拦截事件的场景，无特殊需求不需要编写额外逻辑
    }
})

方式2：单个Item精确触摸监听（更推荐） #

如果只需要响应单个条目的触摸事件，不需要全局拦截，直接在适配器绑定阶段给对应itemView挂载监听器即可，逻辑更独立，不会干扰RecyclerView原生滑动行为：

// 在RecyclerView.Adapter的onBindViewHolder方法中实现
override fun onBindViewHolder(holder: YourViewHolder, position: Int) {
    holder.itemView.setOnTouchListener { view, event ->
        when (event.action) {
            MotionEvent.ACTION_DOWN -> {
                // 示例：按下时给item添加缩放高亮效果
                view.animate().scaleX(0.98f).scaleY(0.98f).setDuration(100).start()
            }
            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                // 示例：触摸结束时恢复item初始状态
                view.animate().scaleX(1f).scaleY(1f).setDuration(100).start()
            }
        }
        // 返回false代表不消费事件，后续item的点击、长按事件可正常触发
        false
    }

    // 其余视图绑定逻辑
}

常见绑定失败排查点 #

• 挂载时机错误：触摸监听器必须在 RecyclerView 完成 LayoutManager、Adapter 绑定后再添加，禁止在布局未完成加载时调用
• 事件返回值配置错误：onInterceptTouchEvent 非拦截场景必须返回false，返回true会抢占列表本身的滚动事件、子View点击事件，导致列表滑动失效、子控件无响应
• 位置索引计算错误：定位触摸对应条目时，必须通过rv.getChildAdapterPosition(childView)获取适配器真实位置，禁止手动计算索引导致条目错位
• 子控件抢占事件：如果item内部包含Button、EditText、可滑动控件等默认消费触摸事件的组件，需要将监听器绑定到实际响应的控件上，或关闭对应子控件的触摸消费属性

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