Gluon Scene Builder：能否使用未构建的应用源代码自定义控件？

当然有办法啦！我之前做Gluon项目的时候也碰到过这个需求，下面就给你一步步讲清楚怎么操作：

1. 把你的项目关联到Scene Builder的类路径 #

Scene Builder需要能找到你自定义控件的类文件，所以第一步就是把你的项目导入进去：

• 打开Scene Builder，点击顶部菜单栏的File -> Import Project...
• 选择你项目的根目录（不管是Maven、Gradle还是普通Java项目都可以）
• 确认导入后，Scene Builder会自动扫描项目里的编译类和依赖库

这里要注意：你的项目得先至少编译一次，生成对应的.class文件（Maven执行mvn compile，Gradle执行gradle compileJava，普通项目直接在IDE里编译就行），不然Scene Builder找不到你的自定义控件类。

2. 确保自定义控件符合Scene Builder的要求 #

你的自定义控件得满足几个基本条件，才能被Scene Builder正确识别：

• 必须继承自JavaFX的Control类（或者它的子类，比如Button、Pane这些）
• 要有无参的默认构造函数——因为Scene Builder需要实例化你的控件来预览
• 如果你的控件用FXML定义内部布局，记得加上@FXML注解，必要时可以用@DefaultProperty指定默认的子节点属性，方便在Scene Builder里拖放子元素

举个简单的自定义控件例子：

package com.yourcompany.yourapp;

import javafx.scene.control.Button;

public class CustomActionButton extends Button {
    // 必须要有无参构造函数
    public CustomActionButton() {
        super("我的自定义按钮");
        setStyle("-fx-background-color: #2ecc71; -fx-text-fill: white;");
    }
}

3. 在Scene Builder里使用自定义控件 #

类路径配置好之后，就可以用两种方式添加自定义控件：

• 可视化拖拽：在左侧的Library面板里，找到Custom分类，里面就会列出你项目里的自定义控件，直接拖到设计界面就行
• 手动编写FXML：直接在FXML编辑器里写控件的全类名标签，比如：

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

<?import com.yourcompany.yourapp.CustomActionButton?>
<?import javafx.scene.layout.VBox?>

<VBox xmlns="http://javafx.com/javafx/17" xmlns:fx="http://javafx.com/fxml/1">
    <CustomActionButton />
</VBox>

写完之后Scene Builder会自动识别并显示控件的预览效果。

4. 开发过程中的更新技巧 #

如果你在修改自定义控件的代码，记得要：

• 重新编译项目，生成新的.class文件
• 在Scene Builder里点击File -> Reload Project，这样就能加载最新的控件定义，不用重新导入项目

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