Android WebView如何阻止双击传递到内部HTML 同时允许单击事件生效

核心实现逻辑：通过Android系统原生的GestureDetector完成双击手势识别，仅在识别到双击事件时消费触摸事件，其余所有触摸事件正常透传给WebView，全程不需要修改前端HTML/JS代码。

实现代码（Kotlin） #

1. 初始化手势检测器 #

在Activity/Fragment中声明并初始化GestureDetector，用于识别双击、单击手势：

val gestureDetector = GestureDetector(context, object : GestureDetector.SimpleOnGestureListener() {
    override fun onDoubleTap(e: MotionEvent): Boolean {
        // 识别到双击事件，返回true表示消费该事件
        return true
    }

    override fun onDown(e: MotionEvent): Boolean {
        // 必须返回true才能接收后续的手势事件
        return true
    }
})

2. 给WebView设置触摸监听器 #

将WebView的触摸事件转发给手势检测器处理，根据检测器的返回值决定是否拦截事件：

webView.setOnTouchListener { v, event ->
    // 手势检测器消费了事件（识别到双击）就返回true拦截，否则返回false透传给WebView
    gestureDetector.onTouchEvent(event)
}

补充说明 #

• 系统默认的双击判定间隔为300ms，如果需要自定义间隔阈值，可以自定义继承GestureDetector修改相关参数
• 该方案不会影响WebView内的长按、滑动、单击等其余手势的正常触发

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