JavaFX自定义ScrollPane缩放ImageView时出现空白区域问题

你的问题出在缩放方式与ScrollPane布局逻辑不匹配上：

你通过setScaleX/Y对ImageView做变换缩放，但这种视觉缩放不会改变节点的layoutBounds（布局边界）。ScrollPane是基于内容节点的layoutBounds计算滚动范围的，所以当小图片放大后，ScrollPane依然认为内容还是原来的小尺寸，导致滚动范围计算错误，无法滚动到图片底部，最终显示空白区域。再加上你设置了fitToHeight=true强制让VBox（内容容器）高度等于视口高度，进一步限制了图片的显示区域。

下面给出两种可行的解决办法：

方案一：改用ImageView原生缩放（推荐） #

放弃scale变换，直接用ImageView的fitWidth和fitHeight属性控制缩放，这种方式会同步更新节点的layoutBounds，让ScrollPane能正确计算滚动范围。

修改ZoomableScrollPane的代码：

1. 更新缩放逻辑：

private void updateScale() {
    if (target instanceof ImageView) {
        ImageView imageView = (ImageView) target;
        Image image = imageView.getImage();
        if (image != null) {
            // 按比例缩放图片
            imageView.setFitWidth(image.getWidth() * scaleValue);
            imageView.setFitHeight(image.getHeight() * scaleValue);
            imageView.setPreserveRatio(true); // 保持原图比例
        }
    }
}

2. 调整ScrollPane的布局属性：
   在setTarget方法中，把强制适配视口的属性关掉：

// 替换原来的setFitToHeight/Width(true)
setFitToHeight(false);
setFitToWidth(false);

方案二：修复Scale变换的边界计算 #

如果坚持用scale变换，需要手动更新容器的边界，让ScrollPane识别到缩放后的真实尺寸：

1. 修改updateScale方法，同步更新Group的预定义大小：

private void updateScale() {
    target.setScaleX(scaleValue);
    target.setScaleY(scaleValue);
    // 手动设置Group的大小为缩放后的图片尺寸
    if (zoomNode instanceof Group) {
        Group group = (Group) zoomNode;
        Bounds targetBounds = target.getLayoutBounds();
        group.setPrefSize(targetBounds.getWidth() * scaleValue, targetBounds.getHeight() * scaleValue);
    }
}

2. 同样需要把setFitToHeight/Width设为false，避免强制容器适配视口。

额外优化 #

如果不需要图片默认居中显示，可以去掉centeredNode方法里的VBox，直接用Group作为外层容器，减少一层布局嵌套带来的干扰：

private Node outerNode(Node node) {
    node.setOnScroll(e -> {
        e.consume();
        onScroll(e.getTextDeltaY(), new Point2D(e.getX(), e.getY()));
    });
    return node;
}

内容的提问来源于stack exchange，提问作者Karim Khasan