如何从JavaFX的Stage中获取嵌套的子节点/面板？

需要获取嵌套在BorderPane（fx:id为borderPane2）中的StackPane（fx:id为topBar），该BorderPane又嵌套在根BorderPane（fx:id为rootPane）内。界面通过Scene Builder/FXML创建，目前仅能通过Parent获取不可修改的子节点列表，无法深入访问到目标StackPane。

FXML层级结构 #

<BorderPane fx:id="rootPane" focusTraversable="true" minHeight="0.0" minWidth="0.0" prefHeight="771.0" prefWidth="1100.0" stylesheets="@styling.css" xmlns="http://javafx.com/javafx/18" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.example.passwordmanager2.HelloController">
   <center>
      <BorderPane fx:id="borderPane2" BorderPane.alignment="CENTER">
         <top>
            <StackPane fx:id="topBar" alignment="TOP_CENTER" focusTraversable="true" prefHeight="95.0" BorderPane.alignment="CENTER">
               <children>
                  .....
               </children>
            </StackPane>
         </top>
      </BorderPane>
   </center>
</BorderPane>

当前Main方法代码 #

public class HelloApplication extends Application {
    @Override
    public void start(Stage stage) throws IOException {
        FXMLLoader fxmlLoader = new FXMLLoader(HelloApplication.class.getResource("hello-view.fxml"));
        double width = 900.0;
        double height = 950.0;

        Scene scene = new Scene(fxmlLoader.load(), width, height);
        Parent root = fxmlLoader.getRoot();
        System.out.println(root.getChildrenUnmodifiable().get(3)); // trying to get stackPane

        stage.setScene(scene);
        stage.initStyle(StageStyle.UNDECORATED);

        ResizeHelper.addResizeListener(stage);

        stage.show();
    }

    public static void main(String[] args) {
        launch();
    }
}

方法一：通过FXML控制器直接注入（推荐） #

这是JavaFX官方推荐的规范做法，无需手动遍历节点层级：

1. 在HelloController类中添加对应字段并标注@FXML：

public class HelloController {
    @FXML
    private StackPane topBar; // 字段名必须和FXML中的fx:id完全一致

    // 节点加载完成后自动调用的初始化方法
    @FXML
    public void initialize() {
        // 此处可直接操作topBar
        System.out.println("获取到目标StackPane：" + topBar);
    }
}

FXML加载器会自动完成节点注入，无需额外代码处理层级关系。

方法二：在Main类中直接获取节点 #

如果必须在Main类中访问目标节点，有两种实现方式：

方式A：通过fx:id直接查找

@Override
public void start(Stage stage) throws IOException {
    FXMLLoader fxmlLoader = new FXMLLoader(HelloApplication.class.getResource("hello-view.fxml"));
    Scene scene = new Scene(fxmlLoader.load(), 900.0, 950.0);
    
    // 注意：必须在load()之后调用lookup，传入带#的fx:id
    StackPane topBar = (StackPane) scene.lookup("#topBar");
    if (topBar != null) {
        System.out.println("获取到目标StackPane：" + topBar);
    }

    stage.setScene(scene);
    stage.initStyle(StageStyle.UNDECORATED);
    ResizeHelper.addResizeListener(stage);
    stage.show();
}

方式B：逐层遍历节点层级

@Override
public void start(Stage stage) throws IOException {
    FXMLLoader fxmlLoader = new FXMLLoader(HelloApplication.class.getResource("hello-view.fxml"));
    Scene scene = new Scene(fxmlLoader.load(), 900.0, 950.0);
    
    // 逐层获取嵌套节点
    BorderPane rootPane = (BorderPane) fxmlLoader.getRoot();
    BorderPane borderPane2 = (BorderPane) rootPane.getCenter();
    StackPane topBar = (StackPane) borderPane2.getTop();
    
    System.out.println("获取到目标StackPane：" + topBar);

    stage.setScene(scene);
    stage.initStyle(StageStyle.UNDECORATED);
    ResizeHelper.addResizeListener(stage);
    stage.show();
}

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