<fx:root>
обеспечивает решение проблемы определения повторно используемого компонента с помощью FXML.
В качестве примера предположим, что вы хотите определить простой пользовательский компонент, состоящий из TextField
и Button
содержащихся в HBox
. Вам нужно, чтобы это было представлено подклассом Node
, поэтому вы можете написать код, например
VBox vbox = new VBox();
vbox.getChildren().add(new MyComponent());
. Проблема в том, что вам нужен класс Java, который является подклассом Node
, а также FXML. В чистой Java (без FXML) вы можете сделать это с помощью:
public class MyComponent extends HBox {
private TextField textField ;
private Button button ;
public MyComponent() {
textField = new TextField();
button = new Button();
this.getChildren().addAll(textField, button);
}
}
Использование FXML для определения настраиваемого компонента без элемента <fx:root>
представляет проблему, потому что вам нужен FXML, чтобы быть чем-то вроде узла, а затем другой экземпляр узла для представления класса, обертывающего его:
<HBox>
<TextField fx:id="textField"/>
<Button fx:id="button" />
</HBox>
и
public class MyComponent extends HBox {
@FXML
private TextField textField ;
@FXML
private Button button ;
public MyComponent() {
try {
FXMLLoader loader = new FXMLLoader(getClass().getResource("MyComponent.fxml"));
loader.setController(this);
HBox hbox = loader.load();
this.getChildren().add(hbox);
} catch (IOException exc) {
// handle exception
}
}
}
Это приводит к тому, что MyComponent состоит из HBox, обертывающего HBox, обертывающий TextField и кнопка. Дополнительный избыточный HBox является результатом необходимости использования одного узла для корня FXML и одного узла для представления компонента.
<fx:root>
дает механизм для создания Узла в качестве компонента (класс Java) и затем проинструктировать файл FXML использовать этот узел в качестве его корня:
<fx:root type="javafx.scene.layout.HBox">
<TextField fx:id="textField" />
<Button fx:id="button" />
</fx:root>
и
public class MyComponent extends HBox {
@FXML
private TextField textField ;
@FXML
private Button button ;
public MyComponent() {
try {
FXMLLoader loader = new FXMLLoader(getClass().getResource("MyComponent.fxml"));
loader.setController(this);
loader.setRoot(this);
loader.load();
} catch (IOException exc) {
// handle exception
}
}
}
Теперь MyComponent
имеет ту же структуру, что и исходная версия all-Java , a HBox
, содержащий TextField
и Button
. Вы не можете сделать это с помощью FXML без элемента <fx:root>
.