如何从FXML或Scene Builder访问JavaFX自定义组件的变量？

嘿，这个需求我太熟悉了！要让你的自定义组件（比如SliderVariable）能在FXML和Scene Builder里直接编辑属性，核心是利用JavaFX的属性绑定机制，给你的组件类规范定义属性，这样Scene Builder才能识别并展示可编辑选项，FXML也能直接赋值或绑定。下面一步步讲清楚：

别用普通的String title这种字段，改用JavaFX的StringProperty（对应字符串类型）、IntegerProperty（数字）这类属性类。这些类是JavaFX绑定系统的核心，也是Scene Builder识别属性的关键。

比如在你的SliderVariable类里：

import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.scene.control.VBox;
import javafx.fxml.FXMLLoader;
import java.io.IOException;

public class SliderVariable extends VBox {
    // 标题属性，默认值设为"默认标题"
    private final StringProperty title = new SimpleStringProperty(this, "title", "默认标题");
    // 默认文本属性，默认值为空
    private final StringProperty defaultText = new SimpleStringProperty(this, "defaultText", "");

    // 构造方法（用fx:root方式加载FXML，避免嵌套布局）
    public SliderVariable() {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("SliderVariable.fxml"));
        loader.setRoot(this);
        loader.setController(this);
        try {
            loader.load();
        } catch (IOException e) {
            throw new RuntimeException("加载SliderVariable FXML失败", e);
        }
    }
}

Scene Builder和FXML依赖固定的方法命名规则来识别属性，必须严格遵循：

• 获取属性值：getXxx()
• 设置属性值：setXxx()（仅适用于可写属性）
• 获取属性对象：xxxProperty()

给上面的属性补上这些方法：

// Title属性相关方法
public String getTitle() {
    return title.get();
}

public void setTitle(String newTitle) {
    this.title.set(newTitle);
}

public StringProperty titleProperty() {
    return title;
}

// DefaultText属性同理
public String getDefaultText() {
    return defaultText.get();
}

public void setDefaultText(String newText) {
    this.defaultText.set(newText);
}

public StringProperty defaultTextProperty() {
    return defaultText;
}

现在要把这些属性和组件内部的Label、TextField关联起来，这样修改属性时，控件会自动更新。

如果用fx:root方式（推荐），FXML可以这么写：

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

<?import javafx.scene.control.Label?>
<?import javafx.scene.control.Slider?>
<?import javafx.scene.control.TextField?>
<?import javafx.scene.layout.VBox?>

<fx:root type="VBox" xmlns:fx="http://javafx.com/fxml" spacing="8">
    <!-- 把Label的text绑定到根节点的title属性 -->
    <Label text="${fx:root.title}" />
    <Slider fx:id="slider" />
    <!-- 把TextField的text绑定到根节点的defaultText属性 -->
    <TextField text="${fx:root.defaultText}" />
    <!-- 这里添加你的InfoIcon组件 -->
</fx:root>

如果是单独的FXML+控制器模式，就把绑定目标改成控制器的属性：

<Label text="${controller.title}" />

做完上面的步骤，就可以让Scene Builder识别你的组件了：

• 把你的组件打包成Jar文件，或者直接在Scene Builder里添加项目的类路径（路径：Library -> Import JAR/FXML File）。
• 导入后，SliderVariable会出现在自定义组件面板里，拖到界面上后，右侧的Properties面板里就能看到你定义的title、defaultText这些属性，直接输入值就能修改。
• 如果属性没显示，检查方法命名是否严格遵循规范，或者可以给属性加上@Property注解（部分版本的Scene Builder需要这个来明确识别）：

import javafx.beans.Property;

@Property
private final StringProperty title = new SimpleStringProperty(this, "title", "默认标题");

你还可以直接在FXML里给组件的属性赋值，比如：

<?import com.yourpackage.SliderVariable?>

<VBox xmlns:fx="http://javafx.com/fxml">
    <!-- 直接设置title和defaultText属性 -->
    <SliderVariable title="音量调节" defaultText="50" />
</VBox>

如果想支持这种直接初始化，还可以给组件加一个带@NamedArg注解的构造方法，让FXML能直接传递参数：

import javafx.util.NamedArg;

public SliderVariable(@NamedArg("title") String title, @NamedArg("defaultText") String defaultText) {
    this();
    setTitle(title);
    setDefaultText(defaultText);
}

这样操作下来，你的自定义组件就和JavaFX原生控件一样，既能在Scene Builder里可视化编辑属性，也能在FXML里直接配置，完全满足你的需求！

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