Javascript.md

Javascript support in Ride

Ride uses Nashorn to execute javascript code. Nashorn is initiated with:

1. "--language=es6" meaning there is some support for ES 6 (though not 100%)
2. Adding two functions ta make it easier to handle tabular (2d array) data
   1. transpose which transposes all columns of a 2d array into rows
   2. View which allows you to view the content of a 2d array in the Ride "View" tab.

Here are some simple examples:

View([
[1,2,3,4,5],
['a', 'b', 'cd', 'efg', 'åäö'],
[true, false, NaN, null, undefined]
], "horizontal");

Which will look similar to this:

V0	V1	V2	V3	V4
1	2	3	4	5
a	b	cd	efg	åäö
true	false	NaN	null	undefined

Using transpose you can "flip" it e.g:

View(transpose([
[1,2,3,4,5],
['a', 'b', 'cd', 'efg', 'åäö'],
[true, false, NaN, null, undefined]
]), "vertical");

Which will look similar to this:

V0	V1	V2
1	a	true
2	b	false
3	cd	NaN
4	efg	null
5	åäö	undefined

Interacting with Ride

Since Ride is a javafx application you can take advantage of the javafx integration with Nashorn. Here is an example of creating a Pie chart and showing it in the plots tab:

load("fx:controls.js")

pie=new PieChart();
pie.getData().clear();
pieData=FXCollections.observableArrayList();
pieData.add(new PieChart.Data("Sandwiches", 150));
pieData.add(new PieChart.Data("Salad", 90));
pieData.add(new PieChart.Data("Soup", 155));
pieData.add(new PieChart.Data("Beverages", 210));
pieData.add(new PieChart.Data("Desserts", 400));
pie.setData(pieData);
pie.setAnimated(true);
pie.setTitle("Lunch Sales");
 
inout.display(pie, "pie chart");

See https://docs.oracle.com/en/java/javase/11/scripting/index.html for details of what you can do with the Nashorn Javascript engine.