Nashorn and JavaFX

Interpreting JavaFX Script Application with Nashorn

You can interpret a JavaFX script application with Nashorn using the jjs command with the -fx option. For example, the following command invokes Nashorn to interpret the JavaFXscript.js file:

jjs -fx --module-path /SOMEDIR/javafx-sdk-11/lib --add-modules javafx.controls JavaFXscript.js

Note:

You must explicitly add the JavaFX modules to launch a script as a JavaFX application. If you don’t add them, then the jjs command prints a message and exits:

jjs -fx JavaFXscript.js

JavaFX is not available.
JavaFX modules include javafx.base, javafx.controls, javafx.fxml, javafx.graphics, javafx.media, javafx.swing, and javafx.web. Ensure that you specify all the modules your application requires in the --add-modules option.
Obtain JavaFX from OpenJFX.

A JavaFX script application is similar to the Java equivalent, but Nashorn enables you to simplify many of the JavaFX constructs. Typically, a JavaFX script application contains only the start() function, which is equivalent to the start() method in its Java counterpart. It can also contain the init() and stop() functions.

Using Nashorn to Simplify JavaFX Script Applications

Nashorn enables you to simplify your JavaFX code by not requiring you to declare certain types and enabling you to access certain methods and properties more easily.

By analyzing the examples in Example of a JavaFX Application (HelloWorld.java) and Example of a JavaFX Script Application (HelloWorld.js), you can see how Nashorn enables you to simplify Java code when you write a JavaFX application as a script:

There is no need to declare variable types, import packages, use annotations, specify the class name, and implement its main() method.
Only the JavaFX classes that are instantiated must be declared.
JavaBeans do not require the get and set prefixes, and are treated as JavaScript properties instead of as Java methods. See Using JavaBeans.
Implementing the javafx.event.EventHandler interface does not require you to specify the implemented method explicitly. Because handle() is the only method, Nashorn automatically applies the provided function to the method. See Extending Java Classes.

The JavaFX primary stage is available to Nashorn as a global property $STAGE. This global property enables you to treat the whole script as one start() function (you can still add the init() and stop() functions). Example of a Simpler Version of JavaFX Script Application (HelloWorldSimple.js) contains the source code for a simplified version of the JavaFX script application from Example of a JavaFX Script Application (HelloWorld.js).

Example of a JavaFX Application (HelloWorld.java)

The following example, HelloWorld.java, contains the source code for a simple JavaFX application that displays a button, which when clicked prints "Hello World!" to standard output.

import javafx.application.Application;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class HelloWorld extends Application {
    public static void main(String[] args) {
        launch(args);
    }
    
    @Override
    public void start(Stage primaryStage) {
        primaryStage.setTitle("Hello World!");
        Button btn = new Button();
        btn.setText("Say 'Hello World'");
        btn.setOnAction(new EventHandler<ActionEvent>() {
 
            @Override
            public void handle(ActionEvent event) {
                System.out.println("Hello World!");
            }
        });
        
        StackPane root = new StackPane();
        root.getChildren().add(btn);
        primaryStage.setScene(new Scene(root, 300, 250));
        primaryStage.show();
    }
}

Example of a JavaFX Script Application (HelloWorld.js)

The following example, HelloWorld.js, contains the source code for a JavaFX script application that displays a button, which when clicked prints "Hello World!" to standard output.

var Button = javafx.scene.control.Button;
var StackPane = javafx.scene.layout.StackPane;
var Scene = javafx.scene.Scene;

function start(primaryStage) {
    primaryStage.title = "Hello World!";
    var button = new Button();
    button.text = "Say 'Hello World'";
    button.onAction = function() print("Hello World!");
    var root = new StackPane();
    root.children.add(button);
    primaryStage.scene = new Scene(root, 300, 250);
    primaryStage.show();
}

Example of a Simpler Version of JavaFX Script Application (HelloWorldSimple.js)

The following example, HelloWorldSimple.js, contains the source code for a simplified version of the JavaFX script application using the global property $STAGE.

var Button = javafx.scene.control.Button;
var StackPane = javafx.scene.layout.StackPane;
var Scene = javafx.scene.Scene;

$STAGE.title = "Hello World!";
var button = new Button();
button.text = "Say 'Hello World'";
button.onAction = function() print("Hello World!");
var root = new StackPane();
root.children.add(button);
$STAGE.scene = new Scene(root, 300, 250);
$STAGE.show();

Nashorn Script Objects

In most cases, you should only add the classes that you instantiate or use to access static fields. However, for prototyping purposes, Nashorn predefines a set of scripts that can be loaded to import groups of JavaFX packages and classes. You can load a script using the load() function that takes a string with the name of the script.

The following table lists the predefined script objects that are available for inclusion:

This script ...	Imports ...
fx:base.js	javafx.stage.Stage javafx.scene.Scene javafx.scene.Group javafx/beans javafx/collections javafx/events javafx/util
fx:graphics.js	javafx/animation javafx/application javafx/concurrent javafx/css javafx/geometry javafx/print javafx/scene javafx/stage
fx:controls.js	javafx/scene/chart javafx/scene/control
fx:fxml.js	javafx/fxml
fx:web.js	javafx/scene/web
fx:media.js	javafx/scene/media
fx:swing.js	javafx/embed/swing
fx:swt.js	javafx/embed/swt

Example of a JavaFX Script Application with Loaded Scripts contains the source code of the simplified JavaFX script application from Example of a Simpler Version of JavaFX Script Application (HelloWorldSimple.js) with load() functions used to import the necessary packages and classes.

Example of a JavaFX Script Application with Loaded Scripts

The following example contains the source code for a simplified version of the JavaFX script application using the load() functions to import packages and classes:

load("fx:base.js");
load("fx:controls.js");
load("fx:graphics.js");

$STAGE.title = "Hello World!";
var button = new Button();
button.text = "Say 'Hello World'";
button.onAction = function() print("Hello World!");
var root = new StackPane();
root.children.add(button);
$STAGE.scene = new Scene(root, 300, 250);
$STAGE.show();

For more examples of JavaFX script applications, see JavaFX Script Application Examples.