javafx
Créateur de scène

Introduction

Remarques

Projet JavaFX de base utilisant FXML

C'est un projet de base qui utilise FXML, créé avec NetBeans (Nouveau projet -> JavaFX -> Application JavaFX FXML). Il ne contient que trois fichiers:

Classe d'application principale

package org.stackoverflow;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

public class BasicApplication extends Application {

    @Override
    public void start(Stage stage) throws Exception {
        Parent root = FXMLLoader.load(getClass().getResource("BasicFXML.fxml"));

        Scene scene = new Scene(root);

        stage.setScene(scene);
        stage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

Fichier FXML

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

<?import java.lang.*?>
<?import java.util.*?>
<?import javafx.scene.*?>
<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>

<AnchorPane id="AnchorPane" prefHeight="200" prefWidth="320" xmlns:fx="http://javafx.com/fxml/1" fx:controller="org.stackoverflow.BasicFXMLController">
    <children>
        <Button layoutX="126" layoutY="90" text="Click Me!" onAction="#handleButtonAction" fx:id="button" />
        <Label layoutX="126" layoutY="120" minHeight="16" minWidth="69" fx:id="label" />
    </children>
</AnchorPane>

Manette

package org.stackoverflow;

import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.control.Label;

public class BasicFXMLController {

    @FXML
    private Label label;

    public void initialize() {
        // TODO
    }   

    @FXML
    private void handleButtonAction(ActionEvent event) {
        label.setText("Hello World!");
    }

}

Courir

Construire et exécuter le projet devrait afficher une petite fenêtre avec un bouton cliquable:

Comment ça marche

En bref, dans la classe Application principale, FXMLLoader chargera basicFXML.fxml partir du basicFXML.fxml jar / classpath, comme spécifié par FXMLLoader.load(getClass().getResource("BasicFXML.fxml")) .

Lors du chargement de basicFXML.fxml , le chargeur trouvera le nom de la classe du contrôleur, comme spécifié par fx:controller="org.stackoverflow.BasicFXMLController" dans le fichier FXML.

Ensuite, le chargeur créera une instance de cette classe, dans laquelle il tentera d'injecter tous les objets ayant un fx:id dans le fichier FXML et qui seront marqués avec l'annotation @FXML dans la classe du contrôleur.

Dans cet exemple, le FXMLLoader créera le libellé basé sur <Label ... fx:id="label"/> et injectera l'occurrence de l'étiquette dans le @FXML private Label label; .

Enfin, lorsque l’ensemble du fichier FXML a été chargé, le FXMLLoader appelle la méthode d’ initialize du contrôleur et le code qui enregistre un gestionnaire d’action avec le bouton est exécuté.

Édition

Bien que le fichier FXML puisse être modifié dans l'EDI, il n'est pas recommandé, car l'EDI ne fournit qu'une vérification de base de la syntaxe et une auto-complétion, mais pas de guidage visuel.

La meilleure approche consiste à ouvrir le fichier FXML avec Scene Builder, où toutes les modifications seront enregistrées dans le fichier.

Scene Builder peut être lancé pour ouvrir le fichier:

Ou le fichier peut être ouvert avec Scene Builder directement depuis l'EDI:

• Dans NetBeans, dans l'onglet Projet, double-cliquez sur le fichier ou cliquez avec le bouton droit de la souris et sélectionnez Open .
• Dans IntelliJ, dans l'onglet Projet, cliquez avec le bouton droit sur le fichier et sélectionnez Open In Scene Builder .
• Dans Eclipse, dans l'onglet Projet, cliquez avec le bouton droit sur le fichier et sélectionnez Open with Scene Builder .

Si Scene Builder est correctement installé et que son chemin d'accès est ajouté à l'EDI (voir Remarques ci-dessous), il ouvre le fichier:

Vous pouvez apporter des modifications en faisant glisser de nouveaux conteneurs ou de nouveaux contrôles à partir des volets de gauche. Les propriétés et les valeurs de disposition peuvent être modifiées dans les volets de droite.

Notez que l'un des tags d'ID permettant d'injecter le FXML dans le code Java est fx:id . Il peut être défini dans le volet Code :

Après avoir appliqué les modifications, enregistrez le fichier (Scene Builder -> Fichier -> Enregistrer). Si des modifications sont apportées à la modification du fichier depuis l'EDI, lors de l'enregistrement du fichier, celles-ci seront mises à jour sur Scene Builder.