JavaFX界面冻结时如何实现可靠的等待加载界面？

一、场景叠加式加载遮罩（推荐） #

完全基于JavaFX原生组件实现，适配屏幕缩放与多显示器，无跨框架兼容性问题。

• 核心思路：在主场景的根容器上叠加一个全屏半透明遮罩，加载开始时显示，完成后隐藏。遮罩内可放置加载动画（如ProgressIndicator）。
• 代码示例：

// 初始化加载遮罩
StackPane loadingOverlay = new StackPane();
loadingOverlay.setStyle("-fx-background-color: rgba(0, 0, 0, 0.7);");
loadingOverlay.setPrefSize(Double.MAX_VALUE, Double.MAX_VALUE);
loadingOverlay.setAlignment(Pos.CENTER);

// 添加自带的加载动画
ProgressIndicator progressIndicator = new ProgressIndicator();
progressIndicator.setStyle("-fx-progress-color: white;");
loadingOverlay.getChildren().add(progressIndicator);

// 将遮罩挂载到主场景根容器（假设主根为BorderPane）
BorderPane mainRoot = (BorderPane) primaryStage.getScene().getRoot();
mainRoot.getChildren().add(loadingOverlay);
loadingOverlay.setVisible(false); // 初始隐藏

// 加载任务逻辑
Runnable loadTask = () -> {
    // 显示遮罩（必须在UI线程执行）
    Platform.runLater(() -> loadingOverlay.setVisible(true));
    
    // 分批添加节点，降低单次UI线程阻塞时长（关键优化）
    int batchSize = 50; // 根据节点复杂度调整
    List<Node> nodesToAdd = generateStyledNodes(); // 你的带样式节点生成逻辑
    for (int i = 0; i < nodesToAdd.size(); i += batchSize) {
        int endIdx = Math.min(i + batchSize, nodesToAdd.size());
        List<Node> batch = nodesToAdd.subList(i, endIdx);
        // 每批节点添加操作委托给UI线程
        Platform.runLater(() -> mainRoot.getCenter().getChildren().addAll(batch));
        // 给UI线程留出发渲染的时间
        try {
            Thread.sleep(50);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            break;
        }
    }
    
    // 加载完成后隐藏遮罩
    Platform.runLater(() -> loadingOverlay.setVisible(false));
};

// 启动后台线程执行加载任务
new Thread(loadTask).start();

二、独立应用模态加载窗口 #

如果主场景在加载时完全无法响应，可创建独立的模态加载窗口，阻塞主窗口操作的同时显示加载状态。

• 核心思路：创建无装饰的模态Stage，居中显示加载动画，加载完成后自动关闭。
• 代码示例：

// 创建加载窗口
Stage loadingStage = new Stage();
loadingStage.initStyle(StageStyle.UNDECORATED);
loadingStage.initModality(Modality.APPLICATION_MODAL);
loadingStage.initOwner(primaryStage); // 绑定到主窗口

// 加载窗口内容
ProgressIndicator progressIndicator = new ProgressIndicator();
progressIndicator.setStyle("-fx-progress-color: #333;");
StackPane loadingRoot = new StackPane(progressIndicator);
loadingRoot.setStyle("-fx-background-color: rgba(255, 255, 255, 0.9);");
loadingRoot.setPrefSize(200, 200);

loadingStage.setScene(new Scene(loadingRoot));
loadingStage.centerOnScreen();

// 加载任务逻辑
Runnable loadTask = () -> {
    Platform.runLater(() -> loadingStage.show());
    
    // 分批添加节点，避免UI线程长时间阻塞
    List<Node> nodesToAdd = generateStyledNodes();
    int batchSize = 50;
    for (int i = 0; i < nodesToAdd.size(); i += batchSize) {
        int endIdx = Math.min(i + batchSize, nodesToAdd.size());
        List<Node> batch = nodesToAdd.subList(i, endIdx);
        Platform.runLater(() -> mainRoot.getCenter().getChildren().addAll(batch));
        try {
            Thread.sleep(50);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            break;
        }
    }
    
    // 关闭加载窗口
    Platform.runLater(loadingStage::close);
};

new Thread(loadTask).start();

三、辅助优化：减少UI阻塞根源 #

除了等待界面，还可以从根源降低节点加载的耗时：

• 预加载CSS样式表：将复杂样式提前加载到Scene或Application中，避免节点添加时重复解析样式。
• 使用虚拟化容器：如果节点是列表/网格形式，改用ListView/TableView等虚拟化组件，仅渲染可见区域的节点，而非一次性添加全部。
• 简化布局层级：减少嵌套布局容器的数量，降低样式应用时的计算量。

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