JavaFX固定高度控件中VirtualFlow垂直滚动条始终可见问题求助

问题背景 #

在JavaFX 23 build 29中，给TableView、ListView、TreeView设置固定高度，且控件因内容过宽显示水平滚动条时，会出现垂直滚动条错误显示的问题：即使控件高度足够容纳所有内容，垂直滚动条仍会显示，只有当控件高度比实际所需高出约14-15px时，滚动条才会隐藏。推测该问题由VirtualFlow的布局计算逻辑导致——水平滚动条显示时，VirtualFlow未正确扣除其高度，误判内容垂直溢出。

临时规避方案 #

1. 动态调整控件高度（推荐） #

在控件布局完成后，检测水平滚动条是否可见，若可见则将控件高度加上水平滚动条的高度，确保VirtualFlow计算垂直空间时能正确容纳内容。

示例代码（以TableView为例）：

import javafx.application.Platform;
import javafx.scene.control.ScrollBar;

// 在loadRoot方法中，添加到tableView初始化完成后
Platform.runLater(() -> {
    ScrollBar hScrollBar = (ScrollBar) tableView.lookup(".scroll-bar:horizontal");
    if (hScrollBar != null && hScrollBar.isVisible()) {
        // 加上水平滚动条的实际偏好高度
        tableView.setMaxHeight(tableView.getMaxHeight() + hScrollBar.getPrefHeight());
    }
});

同理可应用到ListView和TreeView上。

2. 强制隐藏垂直滚动条（仅确认内容不会垂直溢出时使用） #

如果确定控件内容永远不会超出垂直高度，可以直接强制隐藏垂直滚动条：

CSS方式

在原有CSS中添加：

.table-view .scroll-bar:vertical,
.list-view .scroll-bar:vertical,
.tree-view .scroll-bar:vertical {
    -fx-opacity: 0;
    -fx-pref-width: 0;
    -fx-min-width: 0;
    -fx-max-width: 0;
}

代码方式

Platform.runLater(() -> {
    ScrollBar vScrollBar = (ScrollBar) listView.lookup(".scroll-bar:vertical");
    if (vScrollBar != null) {
        vScrollBar.setVisible(false);
        vScrollBar.setManaged(false); // 让控件不占用布局空间
    }
});

3. 用ScrollPane包裹控件（备选） #

将目标控件放入ScrollPane中，由ScrollPane统一管理滚动条，但需注意设置ScrollPane的固定高度，避免嵌套滚动问题：

ScrollPane tableViewWrapper = new ScrollPane(tableView);
tableViewWrapper.setMaxHeight(120);
tableViewWrapper.setFitToWidth(true); // 让TableView自适应ScrollPane宽度，避免内部水平滚动
root.getChildren().add(tableViewWrapper);

根本原因说明 #

该问题属于JavaFX 23的已知布局计算bug，VirtualFlow在处理水平滚动条显示的场景时，未正确将水平滚动条的高度从垂直可用空间中扣除，导致错误触发垂直滚动条的显示。建议关注JavaFX后续版本的更新，官方可能会在后续build或正式版中修复该问题。

内容的提问来源于stack exchange，提问作者Sai Dandem