能否在SceneBuilder/FXML中使用JavaFX Polygon的自定义子类？

当然可以创建继承Polygon的Tile类并在FXML/SceneBuilder中使用，以下是具体解决方案和常见问题排查：

1. 正确实现Tile子类 #

自定义Tile类必须满足两个核心要求：包含无参构造函数（FXMLLoader依赖它实例化控件），以及用JavaFX Property类型定义自定义属性（便于FXML绑定和SceneBuilder识别）。示例代码如下：

package your.package.name;

import javafx.beans.property.ObjectProperty;
import javafx.beans.property.SimpleObjectProperty;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.scene.shape.Polygon;
import java.util.List;

public class Tile extends Polygon {
    // 自定义属性：资源类型、节点集合、边集合
    private final StringProperty resourceType = new SimpleStringProperty();
    private final ObjectProperty<List<Node>> nodes = new SimpleObjectProperty<>();
    private final ObjectProperty<List<Edge>> edges = new SimpleObjectProperty<>();

    // 必须保留无参构造函数，FXMLLoader会自动调用
    public Tile() {
        super();
        // 可选：在这里初始化六边形默认顶点坐标，或者留空由FXML设置
    }

    // ResourceType属性的访问方法（遵循JavaFX Property规范）
    public String getResourceType() {
        return resourceType.get();
    }

    public void setResourceType(String type) {
        this.resourceType.set(type);
    }

    public StringProperty resourceTypeProperty() {
        return resourceType;
    }

    // Nodes和Edges属性的访问方法同理...
}

2. FXML中正确使用Tile #

• 确保导入语句包名与Tile类实际包名完全一致
• 直接使用<Tile>标签替代<Polygon>，同时可设置Polygon原生属性（如points、fill）和自定义属性

示例FXML片段：

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

<?import javafx.scene.layout.Pane?>
<?import your.package.name.Tile?>

<Pane xmlns="http://javafx.com/javafx"
      xmlns:fx="http://javafx.com/fxml/1"
      fx:controller="your.package.name.BoardController">

    <!-- 自定义Tile：设置六边形顶点、填充色、资源类型 -->
    <Tile points="0.0,50.0 43.3,25.0 43.3,-25.0 0.0,-50.0 -43.3,-25.0 -43.3,25.0"
          fill="#f5e79e"
          resourceType="wheat"/>

</Pane>

3. SceneBuilder中配置Tile控件 #

1. 打开SceneBuilder，进入Library面板，点击Import JAR/FXML File
2. 选择包含Tile类的编译后class文件所在目录，或打包好的jar包
3. 导入完成后，Tile会出现在自定义控件库中，可直接拖拽到画布使用，属性面板会自动识别JavaFX Property定义的自定义属性

4. 之前尝试失败的常见原因 #

• 缺少无参构造函数：FXMLLoader无法实例化没有无参构造的自定义控件
• FXML导入包名错误：<?import>语句中的包名必须与Tile类的实际包名完全匹配
• 强制转换Polygon为Tile：FXML中若用<Polygon>标签，实例化的是Polygon对象，无法强制转为子类Tile，必须直接使用<Tile>标签
• 自定义属性未用JavaFX Property：若用普通字段而非Property类型，FXML无法直接设置这些属性，需在控制器中手动赋值

内容的提问来源于stack exchange，提问作者Marco R.