JavaFX嵌套自定义组件在Scene Builder中显示空白问题求助

问题场景 #

我创建了两个JavaFX自定义组件：

• Custom_Button：继承自Button，通过FXML定义样式和属性
• Custom_Pick：继承自HBox，内部嵌套了Custom_Button

运行时两个组件均正常工作，但在Scene Builder中：

• Custom_Button单独使用时显示正常
• 单独打开Custom_Pick的FXML文件能正常渲染
• 将Custom_Pick作为组件添加到其他布局时，仅显示空白面板

组件代码 #

Custom_Button 实现 #

Java代码

public class Custom_Button extends Button {
    public Custom_Button() {
        super();
        try{
            FXMLLoader loader=new FXMLLoader(getClass().getResource("/eu/mylib/libraries_custom_/custom_button/Custom_Button.fxml"));
            loader.setRoot(this);
            loader.setController(this);
            loader.load();
        }catch (Exception e){
            e.printStackTrace();
        }                   
    }
}

FXML文件

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.Button?>

<fx:root prefHeight="106.0" prefWidth="168.0" stylesheets="@Custom_Button.css" text="RED" type="javafx.scene.control.Button" xmlns="http://javafx.com/javafx/19" xmlns:fx="http://javafx.com/fxml/1">
</fx:root>

Custom_Pick 实现 #

Java代码

public class Custom_Pick extends HBox {
    public Custom_Pick() {
        super();
        try{
            FXMLLoader loader=new FXMLLoader(getClass().getResource("/eu/mylib/libraries_custom_/custom_pick/Custom_Pick.fxml"));
            loader.setRoot(this);
            loader.setController(this);
            loader.load();
        }catch (Exception e){
            e.printStackTrace();
        }
    }
}

FXML文件

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.layout.*?>
<?import eu.mylib.libraries_custom_.custom_button.Custom_Button?>

<fx:root type="javafx.scene.layout.HBox" xmlns="http://javafx.com/javafx"
            xmlns:fx="http://javafx.com/fxml"
            prefHeight="400.0" prefWidth="600.0">
    <Custom_Button></Custom_Button>
</fx:root>

相关截图 #

• 单独打开Custom_Pick的FXML时渲染正常：
• Custom_Button导入库后正常显示：
• Custom_Pick作为组件显示空白面板：
• 项目结构：

解决方法 #

1. 修复资源加载路径 #

Scene Builder在加载嵌套组件时，可能无法通过getClass().getResource(...)正确找到子组件的资源文件。改用类加载器加载资源：

// 修改Custom_Button构造器中的资源加载逻辑
FXMLLoader loader = new FXMLLoader(getClass().getClassLoader().getResource("eu/mylib/libraries_custom_/custom_button/Custom_Button.fxml"));

同样修改Custom_Pick中的资源加载路径，确保资源路径为完整的类路径格式（不带开头的/）。

2. 清理Scene Builder缓存 #

打开Scene Builder，依次点击File -> Clear Caches，重启后重新加载组件库，避免旧缓存导致的渲染异常。

3. 调整组件初始化时机 #

将FXML加载逻辑从构造器移到Initializable接口的initialize()方法中，确保Scene Builder能正确触发组件初始化：

public class Custom_Button extends Button implements Initializable {
    public Custom_Button() {
        super();
    }

    @Override
    public void initialize(URL location, ResourceBundle resources) {
        try{
            FXMLLoader loader=new FXMLLoader(getClass().getClassLoader().getResource("eu/mylib/libraries_custom_/custom_button/Custom_Button.fxml"));
            loader.setRoot(this);
            loader.setController(this);
            loader.load();
        }catch (Exception e){
            e.printStackTrace();
        }
    }
}

对Custom_Pick做同样修改。

4. 验证组件注册与导入 #

• 确保自定义组件的JAR包已正确导入Scene Builder，且包路径与FXML中的导入语句完全一致
• 检查FXML的JavaFX命名空间版本（如xmlns="http://javafx.com/javafx/19"）与项目使用的JavaFX版本匹配

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