JavaFX主FXML中<fx:include>标签位置及加载错误排查

错误原因分析 #

报错**"Element does not define a default property"**是因为你把<fx:include>放在了没有默认子属性的父节点里。比如直接放在ToolBar标签内——ToolBar的子元素需要通过items属性声明，而非直接作为子节点嵌套；只有VBox、HBox（默认属性为children）、BorderPane（默认属性为center）这类容器，才能直接放置<fx:include>或其他子组件。

修正fx:include的正确用法（若需嵌入UI） #

如果确实需要将NTB的UI嵌入主界面，要把<fx:include>放在有默认子属性的容器中，比如VBox：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.BorderPane?>
<?import javafx.scene.control.ToolBar?>
<?import javafx.scene.control.Button?>
<?import javafx.scene.control.TableView?>
<?import javafx.scene.layout.VBox?>

<BorderPane xmlns="http://javafx.com/javafx"
            xmlns:fx="http://javafx.com/fxml"
            fx:controller="com.example.TestController">
    <top>
        <ToolBar>
            <Button fx:id="newTask" text="New Task"/>
        </ToolBar>
    </top>
    <center>
        <VBox>
            <TableView fx:id="taskTable"/>
            <!-- 正确：放在VBox的默认children属性下 -->
            <fx:include fx:id="NTB" source="NTB.fxml"/>
        </VBox>
    </center>
</BorderPane>

更简便的弹窗实现方式（符合你的需求） #

因为你需要的是点击按钮弹出独立输入窗口，而非嵌入UI，完全不需要<fx:include>。直接在主控制器中加载FXML并创建弹窗即可，步骤如下：

1. 主控制器TestController.java #

package com.example;

import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.TableView;
import javafx.stage.Modality;
import javafx.stage.Stage;
import java.io.IOException;

public class TestController {
    @FXML private TableView<Task> taskTable;
    @FXML private Button newTask;

    @FXML
    public void initialize() {
        // 绑定按钮点击事件
        newTask.setOnAction(e -> openNewTaskWindow());
    }

    private void openNewTaskWindow() {
        try {
            // 加载NTB的FXML文件
            FXMLLoader loader = new FXMLLoader(getClass().getResource("NTB.fxml"));
            Parent root = loader.load();

            // 获取弹窗控制器，传递主控制器引用以便后续更新表格
            NTBController ntbController = loader.getController();
            ntbController.setMainController(this);

            // 创建模态弹窗（阻塞主窗口操作）
            Stage popupStage = new Stage();
            popupStage.setTitle("新建任务");
            popupStage.setScene(new Scene(root));
            popupStage.initModality(Modality.APPLICATION_MODAL);
            popupStage.showAndWait(); // 等待弹窗关闭后更新表格
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }

    // 供弹窗控制器调用，更新表格数据
    public void refreshTaskTable() {
        // 此处实现表格数据更新逻辑，例如重新加载数据源
        // taskTable.setItems(updatedTaskList);
    }
}

2. 弹窗控制器NTBController.java #

package com.example;

import javafx.fxml.FXML;
import javafx.scene.control.TextField;
import javafx.stage.Stage;

public class NTBController {
    @FXML private TextField taskNameField;
    @FXML private TextField taskDescField;

    private TestController mainController;

    public void setMainController(TestController controller) {
        this.mainController = controller;
    }

    @FXML
    public void saveTask() {
        // 获取用户输入内容
        String taskName = taskNameField.getText();
        String taskDesc = taskDescField.getText();

        // 此处添加任务保存逻辑（如存入数据库或本地列表）

        // 关闭弹窗
        Stage stage = (Stage) taskNameField.getScene().getWindow();
        stage.close();

        // 通知主控制器更新表格
        mainController.refreshTaskTable();
    }

    @FXML
    public void cancel() {
        // 直接关闭弹窗
        Stage stage = (Stage) taskNameField.getScene().getWindow();
        stage.close();
    }
}

3. 弹窗FXML文件NTB.fxml #

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

<VBox xmlns="http://javafx.com/javafx"
      xmlns:fx="http://javafx.com/fxml"
      fx:controller="com.example.NTBController"
      spacing="12"
      padding="20">
    <Label text="任务名称"/>
    <TextField fx:id="taskNameField"/>
    <Label text="任务描述"/>
    <TextField fx:id="taskDescField"/>
    <Button text="保存" onAction="#saveTask"/>
    <Button text="取消" onAction="#cancel"/>
</VBox>

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