Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stefaneidelloth/javafx-d3
Provides a Java API to use the JavaScript library d3.js with the JavaFx WebView
https://github.com/stefaneidelloth/javafx-d3
Last synced: 25 days ago
JSON representation
Provides a Java API to use the JavaScript library d3.js with the JavaFx WebView
- Host: GitHub
- URL: https://github.com/stefaneidelloth/javafx-d3
- Owner: stefaneidelloth
- License: other
- Created: 2015-09-26T07:38:20.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-07-03T17:38:11.000Z (over 6 years ago)
- Last Synced: 2024-02-12T17:02:48.507Z (10 months ago)
- Language: Java
- Size: 2.66 MB
- Stars: 101
- Watchers: 10
- Forks: 21
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeJavaFX - javafx-d3 - javafx-d3 provides a Java API for using the JavaScript library d3.js with JavaFx Applications. (Libraries, Tools and Projects)
README
# javafx-d3 #
Provides a Java API for using the JavaScript library d3.js with JavaFx Applications.
Many thanks to the authors of the projects **gwt-d3** [[1]](https://github.com/gwtd3/gwt-d3 "gwt-d3") and **d3.js** [[2]](http://d3js.org "d3.js") !!!
Most of the source code of javafx-d3 originates from gwt-d3. If you use the original
gwt-d3 project your result will be a web application that is written in JavaScript.
If you use **javafx-d3**, your aim is to create a **JavaFx desktop application**
that is written in Java.
## Current state
* Most code from gwt-d3 has already been transformed.
* In order to keep my efforts focussed, the remaining parts will be done on request.
* Therefore, if you are interested in more functionality, please create an issue ticket.
=> Please also feel free to jump in and directly contribute to the code of javafx-d3.
In terms of stability and performance javafx-d3 seems to work nicely for "smaller projects".
If you want to transfer a lot of data between Java and JavaScript you might get into the
limits of the JavaFx WebView. Hava a look at the scatterplot matrix example of the JavaFxD3DemoSuite
and compare it to the original gwt demo to get an impression of the limitations of the WebView and javafx-d3:
https://gwtd3.github.io/demo/D3Demo.html
Please also see the following SO questions for more information:
http://stackoverflow.com/questions/41488110/java-api-for-manipulating-html-javascript-dom-elements
http://stackoverflow.com/questions/10762979/performance-of-webview-in-javafx
## How it works: ##
Javafx-d3 uses the JavaFx WebView [[3]](https://docs.oracle.com/javafx/2/webview/jfxpub-webview.htm "JavaFx WebView") to display an html page and to execute JavaScript.
The JavaScript library d3.js is injected into the WebView. The communication between Java and JavaScript is based on
so called JSObjects [[4]](http://docstore.mik.ua/orelly/web/jscript/ch19_06.html "Using JavaScript from Java").
With this straregy of javafx-d3 you are able to use the full power of d3.js for your Java desktop applications.
## How to get started: ##
* Get the source code
* You can use the main folder as an Eclipse workspace including two projects:
* Import the two Eclipse Maven projects **javafx-d3** and **javafx-d3-demo**
* Build the maven projects
* Run the demo suite **com.github.javafxd3.d3.JavaFxD3DemoSuite**
* If you do not get javafx-d3 up and running please create an issue ticket.
## License ##
This project is licensed under BSD:
* javafx-d3: https://github.com/stefaneidelloth/javafx-d3/blob/master/LICENSE
Javafx-d3 is based on third party code and you have to consider the corresponding licenses as well:
* d3.js => BSD: https://github.com/mbostock/d3/blob/master/LICENSE
* gwt-d3 => BSD: https://github.com/gwtd3/gwt-d3/blob/master/LICENSE
* function-plot => MIT: https://github.com/maurizzzio/function-plot
* nvd3 => Apache: https://github.com/novus/nvd3/blob/master/LICENSE.md
* jquery.js => JS Foundation https://github.com/jquery/jquery/blob/master/LICENSE.txt
* plotly.js => MIT: https://github.com/plotly/plotly.js/blob/master/LICENSE
----
[1]: gwt-d3: https://github.com/gwtd3/gwt-d3
[2]: d3.js: http://d3js.org
[3]: JavaFx WebView: https://docs.oracle.com/javafx/2/webview/jfxpub-webview.htm
[4]: Using JavaScript from Java: http://docstore.mik.ua/orelly/web/jscript/ch19_06.html
[5]: d3.js gallery: https://github.com/mbostock/d3/wiki/Gallery