JavaFX WebView滚动操作无法捕获的问题排查及解决建议

问题原因 #

1. 滚动条与内核滚动不同步：WebView的JavaFX层级中的ScrollBar仅为视觉展示组件，其valueProperty不会同步WebKit内核处理的所有滚动操作（如鼠标滚轮滚动页面、页面JS触发的滚动），仅手动拖动滚动条时才会触发value变化——这就是你监听无输出的核心原因。
2. 滚动条实例可能被重建：若WebView因页面内容更新、组件重绘导致滚动条实例被重新创建，之前添加的监听会直接失效。

修复方案 #

方案1：通过JavaScript监听页面滚动（推荐，覆盖所有场景） #

利用WebEngine注入JS代码监听页面scroll事件，再通过JS-Java交互传递滚动信息，这种方式能捕获所有类型的滚动操作：

webEngine.getLoadWorker().stateProperty().addListener((ov, oldState, newState) -> {
    if (newState == Worker.State.SUCCEEDED) {
        // 注入JS滚动监听脚本
        webEngine.executeScript("""
            window.addEventListener('scroll', function() {
                scrollCallback(window.scrollY);
            });
        """);
        
        // 注册Java回调函数
        JSObject windowObj = (JSObject) webEngine.executeScript("window");
        windowObj.setMember("scrollCallback", (Consumer<Number>) scrollY -> {
            System.out.println("webview滚动位置：" + scrollY);
        });
    }
});

注：确保WebView的javascriptEnabled属性为true（默认已开启）。

方案2：监听内部ScrollPane的滚动（仅捕获JavaFX层面操作） #

如果只需要捕获拖动滚动条这类JavaFX层面的操作，可以查找WebView内部的ScrollPane并监听其vvalueProperty：

webEngine.getLoadWorker().stateProperty().addListener((ov, oldState, newState) -> {
    if (newState == Worker.State.SUCCEEDED) {
        // 延迟执行确保组件树构建完成
        Platform.runLater(() -> {
            ScrollPane scrollPane = (ScrollPane) webView.lookup(".scroll-pane");
            if (scrollPane != null) {
                scrollPane.vvalueProperty().addListener((observable, oldValue, newValue) -> {
                    System.out.println("webview滚动位置：" + newValue);
                });
            }
        });
    }
});

此方案无法捕获WebKit内核处理的鼠标滚轮、JS滚动等操作。

内容的提问来源于stack exchange，提问作者Lavish Kothari