Android WebView启用缩放后TouchListener仅生效一次的解决求助

问题描述 #

在Android WebView中启用缩放功能后，首次触摸屏幕时onTouchWebView()能正常接收ACTION_DOWN、ACTION_UP、ACTION_MOVE等事件，但第二次触摸后该函数不再被调用。禁用缩放功能时，触摸监听可正常工作。开发环境：Android Studio 2023.3.1，Compile SDK 34，Target SDK 34。

问题原因 #

启用builtInZoomControls后，WebView默认会显示内置的缩放控制按钮，这些按钮属于独立的视图组件。首次触摸后，缩放控制组件可能会拦截后续的触摸事件，导致自定义的OnTouchListener无法收到事件回调。另外，若OnTouchListener的返回值处理不当，也可能引发事件传递异常。

解决方法 #

方法一：关闭屏幕缩放控制按钮（最简单）

保留 pinch-to-zoom 等缩放功能，但关闭屏幕上的缩放控制按钮，避免其拦截触摸事件：

WebSettings webSettings = webView.getSettings();  
webSettings.setBuiltInZoomControls(true);
webSettings.setSupportZoom(true);
// 添加该行关闭屏幕缩放按钮
webSettings.setDisplayZoomControls(false);

方法二：自定义WebView并重写onTouchEvent

通过自定义WebView直接重写onTouchEvent方法，优先处理触摸事件后再交给WebView内部逻辑处理：

public class CustomWebView extends WebView {
    public CustomWebView(Context context) {
        super(context);
        initSettings();
    }

    public CustomWebView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initSettings();
    }

    private void initSettings() {
        WebSettings webSettings = getSettings();
        webSettings.setBuiltInZoomControls(true);
        webSettings.setSupportZoom(true);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        // 先执行自定义触摸逻辑
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                // 你的处理代码
                break;
            case MotionEvent.ACTION_UP:
                // 你的处理代码
                break;
            case MotionEvent.ACTION_MOVE:
                // 你的处理代码
                break;
        }
        // 将事件传递给父类，保证缩放功能正常运作
        return super.onTouchEvent(event);
    }
}

之后在布局文件或代码中用CustomWebView替代原生WebView即可。

方法三：使用GestureDetector处理触摸事件

借助GestureDetector解析触摸事件，同时让WebView保留缩放事件的处理权：

private GestureDetector gestureDetector;

// 在Activity/Fragment的初始化代码中
gestureDetector = new GestureDetector(this, new GestureDetector.SimpleOnGestureListener() {
    @Override
    public boolean onDown(MotionEvent e) {
        // 处理ACTION_DOWN事件
        return true;
    }

    @Override
    public boolean onSingleTapUp(MotionEvent e) {
        // 处理ACTION_UP事件
        return true;
    }

    @Override
    public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
        // 处理ACTION_MOVE事件
        return true;
    }
});

webView.setOnTouchListener((v, event) -> {
    // 让GestureDetector处理触摸事件
    gestureDetector.onTouchEvent(event);
    // 返回false，允许WebView处理缩放相关事件
    return false;
});

额外注意事项 #

确保onTouchWebView方法正确返回布尔值：

• 返回true表示事件已被消费，不会继续传递给WebView内部逻辑；
• 返回false表示事件未被消费，WebView会继续处理该事件（如缩放）。
  若之前代码遗漏返回值，需补充完整避免逻辑异常。

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