在FXML中使用ArrayList报错，无法打开SceneBuilder求助

你遇到的问题主要有两个核心原因：

1. FXML集合元素的声明语法错误：在FXML中直接将<Button>作为<ArrayList>的子节点是不符合规范的，FXML需要明确的引用语法来向集合添加元素。
2. 按钮未加入场景图：你把所有按钮放在<fx:define>块里，这个块里的元素默认不会被添加到场景图中，不仅导致按钮无法显示，还会让SceneBuilder无法正确解析组件结构。

正确的实现方式 #

要实现「按钮显示在界面上，同时被注入到控制器的集合中」，我们可以分两步走：

• 先将按钮作为AnchorPane的直接子节点，确保它们能被渲染和SceneBuilder识别；
• 在<fx:define>中定义ArrayList，通过<fx:reference>引用每个按钮的fx:id来填充集合。

修改后的FXML代码

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.control.*?>
<?import java.lang.*?>
<?import javafx.scene.layout.*?>
<?import javafx.geometry.Insets?>
<?import javafx.scene.layout.GridPane?>
<?import javafx.scene.control.Button?>
<?import javafx.scene.control.Label?>
<?import java.util.ArrayList?>

<AnchorPane fx:controller="sample.Controller" maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" prefHeight="400.0" prefWidth="600.0" xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1">
    <children>
        <!-- 先定义所有按钮，作为AnchorPane的子节点 -->
        <Button fx:id="btn1" layoutX="93.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        <Button fx:id="btn2" layoutX="187.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        <Button fx:id="btn3" layoutX="255.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        <Button fx:id="btn6" layoutX="505.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        <Button fx:id="btn4" layoutX="351.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        <Button fx:id="btn5" layoutX="436.0" layoutY="31.0" mnemonicParsing="false" text="Button" />
        
        <!-- 定义ArrayList并引用已有的按钮 -->
        <fx:define>
            <ArrayList fx:id="buttons">
                <fx:reference source="btn1"/>
                <fx:reference source="btn2"/>
                <fx:reference source="btn3"/>
                <fx:reference source="btn4"/>
                <fx:reference source="btn5"/>
                <fx:reference source="btn6"/>
            </ArrayList>
        </fx:define>
    </children>
</AnchorPane>

控制器代码示例

在控制器中，你只需要用@FXML注解注入这个ArrayList即可：

import javafx.fxml.FXML;
import java.util.ArrayList;
import javafx.scene.control.Button;

public class Controller {
    @FXML
    private ArrayList<Button> buttons;

    // 初始化方法，验证集合是否注入成功
    @FXML
    public void initialize() {
        if (buttons != null) {
            System.out.println("注入的按钮数量：" + buttons.size());
            // 可以遍历集合做后续操作
            buttons.forEach(button -> button.setOnAction(e -> {
                System.out.println("点击了按钮：" + button.getId());
            }));
        }
    }
}

更推荐的替代方案：使用ObservableList #

如果你不需要特定的ArrayList，JavaFX更推荐使用ObservableList，它能自动响应集合变化，而且FXML支持更简洁的写法：

1. 控制器中声明：

@FXML
private ObservableList<Button> buttons;

2. FXML中可以直接用<fx:observableList>替代<ArrayList>，写法和上面的<ArrayList>一致，用<fx:reference>填充元素。

这样修改后，你的FXML就能正常在SceneBuilder中打开，同时按钮会被正确注入到控制器的集合里啦！

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