如何将外部FXML作为标签/库在父FXML中使用并动态传值？

要实现不用<fx:include>而将子FXML作为自定义标签引入父FXML，并动态传递属性，核心是将子FXML封装为自定义JavaFX控件，之后就能像使用原生控件一样在父FXML中直接引用并设置属性。

步骤1：编写子FXML（child.fxml） #

先定义包含目标组件的子布局，这里以Label为例（替换成Text逻辑一致）：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.VBox?>

<VBox xmlns:fx="http://javafx.com/fxml" fx:id="root">
    <Label fx:id="contentLabel" />
</VBox>

步骤2：创建自定义控件类（ChildControl.java） #

继承对应布局容器（这里是VBox），加载子FXML并暴露需要外部设置的属性：

import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.scene.control.Label;
import javafx.scene.layout.VBox;
import java.io.IOException;

public class ChildControl extends VBox {
    @FXML
    private Label contentLabel;

    public ChildControl() {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("child.fxml"));
        loader.setRoot(this); // 将当前控件作为FXML的根节点
        loader.setController(this); // 将当前控件作为FXML的控制器
        try {
            loader.load();
        } catch (IOException e) {
            throw new RuntimeException("加载child.fxml失败", e);
        }
    }

    // 暴露text属性，父FXML设置时会自动调用这个setter
    public void setText(String text) {
        contentLabel.setText(text);
    }

    public String getText() {
        return contentLabel.getText();
    }
}

步骤3：在父FXML（parent.fxml）中使用自定义标签 #

导入自定义控件的包，然后直接以标签形式使用并设置属性：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.BorderPane?>
<?import com.yourpackage.ChildControl?> <!-- 替换为你的实际包名 -->

<BorderPane xmlns:fx="http://javafx.com/fxml" xmlns:custom="com.yourpackage">
    <center>
        <!-- 直接用自定义标签，设置text属性 -->
        <custom:ChildControl text="mytext" />
    </center>
</BorderPane>

原理说明 #

JavaFX的FXML解析器支持直接使用自定义Java控件作为标签，当你在父FXML中设置text="mytext"时，解析器会自动调用自定义控件的setText()方法，从而实现动态填充子组件的属性。如果需要传递更多属性，只需在自定义控件中添加对应的setter/getter方法即可。

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