咨询：样式表加载时修改JavaFX场景图的可行方法

方法1：通过自定义CSS属性触发节点包裹 #

你可以定义一个自定义CSS属性标记需要处理的VBox，再在JAR包中编写初始化工具类，监听并处理这些标记节点：

代码实现 #

import javafx.application.Platform;
import javafx.scene.Node;
import javafx.scene.Parent;
import javafx.scene.layout.StackPane;
import javafx.scene.layout.VBox;
import javafx.scene.paint.Color;
import javafx.scene.shape.Rectangle;

import java.util.concurrent.CompletableFuture;

public class VBoxWrapper {
    static {
        // 延迟到UI线程初始化完成后遍历场景
        CompletableFuture.runAsync(() -> {
            Platform.runLater(() -> {
                if (!javafx.stage.Window.getWindows().isEmpty()) {
                    Parent root = javafx.stage.Window.getWindows().get(0).getScene().getRoot();
                    processVBoxes(root);
                }
            });
        });
    }

    private static void processVBoxes(Node node) {
        if (node instanceof VBox vbox) {
            // 检查是否设置了自定义CSS属性
            Object wrapFlag = vbox.getProperties().get("custom-wrap-vbox");
            if (Boolean.TRUE.equals(wrapFlag)) {
                wrapWithStackPane(vbox);
            }
        }
        if (node instanceof Parent parent) {
            for (Node child : parent.getChildrenUnmodifiable()) {
                processVBoxes(child);
            }
        }
    }

    private static void wrapWithStackPane(VBox vbox) {
        Parent parent = vbox.getParent();
        if (parent == null || parent instanceof StackPane) return;

        // 创建包裹用的StackPane
        StackPane wrapper = new StackPane();
        // 移除原VBox并添加到wrapper
        ((Parent) parent).getChildren().remove(vbox);
        wrapper.getChildren().add(vbox);

        // 添加自定义边框元素（示例为圆角红框）
        Rectangle border = new Rectangle();
        border.setFill(Color.TRANSPARENT);
        border.setStroke(Color.RED);
        border.setStrokeWidth(3);
        border.setArcWidth(10);
        border.setArcHeight(10);
        border.widthProperty().bind(wrapper.widthProperty());
        border.heightProperty().bind(wrapper.heightProperty());
        wrapper.getChildren().add(border);

        // 将wrapper放回原父节点
        ((Parent) parent).getChildren().add(wrapper);
    }
}

样式表配置 #

在CSS中给目标VBox添加标记：

.target-vbox {
    -custom-wrap-vbox: true;
}

触发类初始化 #

要确保VBoxWrapper被类加载器初始化，可以通过在CSS中引用一个自定义资源（如不存在的字体）强制加载该类，或通过服务配置触发。

方法2：使用ServiceLoader实现启动后自动处理 #

通过Java的ServiceLoader机制，在应用启动后自动遍历场景图并修改目标节点：

初始化类实现 #

import javafx.application.Platform;
import javafx.scene.Node;
import javafx.scene.Parent;
import javafx.scene.layout.VBox;
import javafx.stage.Window;

import java.util.ServiceLoader;

public class SceneModifier implements Runnable {

    @Override
    public void run() {
        Platform.runLater(() -> {
            for (Window window : Window.getWindows()) {
                if (window.getScene() != null) {
                    scanScene(window.getScene().getRoot());
                }
            }
        });
    }

    private void scanScene(Node node) {
        if (node instanceof VBox vbox) {
            // 通过CSS类名识别目标VBox
            if (vbox.getStyleClass().contains("target-vbox")) {
                wrapWithStackPane(vbox);
            }
        }
        if (node instanceof Parent parent) {
            parent.getChildrenUnmodifiable().forEach(this::scanScene);
        }
    }

    private void wrapWithStackPane(VBox vbox) {
        // 同方法1的包裹逻辑
        Parent parent = vbox.getParent();
        if (parent == null || parent instanceof StackPane) return;

        StackPane wrapper = new StackPane();
        ((Parent) parent).getChildren().remove(vbox);
        wrapper.getChildren().add(vbox);

        // 添加你需要的装饰元素
        // ...（省略边框代码，同方法1）

        ((Parent) parent).getChildren().add(wrapper);
    }

    // 让ServiceLoader能加载这个类
    public static void main(String[] args) {}
}

服务配置 #

在JAR包中创建META-INF/services/java.lang.Runnable文件，内容为：

com.yourpackage.SceneModifier

应用启动时会自动加载并执行SceneModifier的run方法。

关键注意事项 #

• 所有场景图修改操作必须在JavaFX UI线程执行，务必用Platform.runLater包裹。
• 处理节点时要避免重复操作，可以给已处理节点添加标记（如vbox.getProperties().put("wrapped", true)）。
• 如果应用有动态加载的场景或多窗口，需要添加监听逻辑处理后续创建的节点。

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